Skip to main content

​
認証方法

すべての公開 API は、デフォルトで Bearer Token を使用します：
ベース URL：
一部のネイティブ形式またはモデル専用インターフェースはパスが異なりますが、API Key の認証方式は同じです。

​
エラー構造

失敗したリクエストを調査する際は、以下を優先的に確認してください：
  • HTTP ステータスコード
  • error.code
  • error.message
代表的な構造：

​
主なステータスコード

​
一般的なステータス列挙値

一般的なロール (Role) 列挙値：
  • system
  • user
  • assistant
一般的な長時間タスクのステータス：
  • queued
  • running
  • succeeded
  • failed
  • in_progress
  • completed
ビデオ API によって返されるステータスフィールドは若干異なる場合がありますが、意味は「待機中 / 実行中 / 完了 / 失敗」を基本としています。

​
非同期タスクのクエリ

現在の公開ドキュメントは「タスク結果の能動的なクエリ」を主体としており、主な方法には以下が含まれます：
  • GET /v1/videos/{task_id}
  • GET /v1/responses/{response_id}
  • GET /api/v3/contents/generations/tasks/{task_id}
  • GET /suno/fetch/{task_id}
  • GET /ent/v2/tasks/{task_id}/creations
  • GET /v1beta/{operation_name}
実装側への推奨事項：
  • タスククエリに対して再試行とエクスポネンシャルバックオフを実施する
  • task_id または operation_name を永続化して保存する
  • 結果照会は、非同期タスクのポーリング（回查）におけるフォールバック手段として利用します