Skip to main content
POST
AIReiter における Suno のモデル名は suno です。歌詞、継続作成、カバーにはそれぞれ suno_lyrics、suno_extend、suno_cover を使用してください。

Authorizations

string
必須
すべてのエンドポイントは Bearer Token による認証が必要です。API Key の取得:API Key 管理ページ にアクセスして、API Key を取得してください。使用時はリクエストヘッダーに以下を追加します:

Body

string
必須
モデル名。固定で次を使用します:
  • suno
object
必須
モデルパラメータのオブジェクト。
string
必須
呼び出し元のタスク ID。ユーザーが定義するタスク識別子です。必須です。英字、数字、アンダースコア、ハイフンのみ使用でき、長さは 1〜64 文字です。後続でこの ID を使用してタスクの状態と結果を確認できます。

Response

string
発行元のタスク ID。結果の照会に使用できます。
string
初期状態で、通常は "pending" です。
string
作成時刻。ISO 形式。

Query Task

Suno は非同期の音楽生成モデルです。タスクを送信した後は、out_task_id を使用してタスクの状態を確認してください。完了後、output には通常2曲が含まれ、各項目には audio(音声URL)、url(カバー画像)、title、text(歌詞)が含まれます。
string
必須
タスク送信時に渡す発信側のタスクID。
クエリが成功し、完了した後の output の例:

Request Examples

Mode Notes

シンプルモードでは prompt だけが必要です。カスタムモードでは title と style を両方送信してください。ボーカルありの場合は、歌詞を prompt に記入してください。
vocal_gender は instrumental が false の場合にのみ有効です。1回のリクエストでは通常2曲の候補が返されます。