TokenLab
API キーを取得
ドキュメントAPIリファレンス連携

音楽

音楽の作成

Sunoを使用して音楽生成タスクを作成します

POST
/v1/music/generations

AIを使用して音楽と歌詞を生成します。これは非同期 API です。作成レスポンスはタスク ID を返し、利用可能な場合は優先して使う poll_url も返します。

リクエストボディ

modelstringデフォルト: suno_music

音楽モデル ID。例: suno-music。歌詞のみの場合は、現在の公開操作に lyrics を含むモデルを選んでください。

promptstring

音楽の説明または置換テキスト。音楽、歌詞、upload-cover、upload-extend、replace-section では必須です。add-instrumental と音源分離では省略できます。

titlestring

生成された曲のタイトル。

tagsstring

スタイルタグ（例：「pop, upbeat, electronic」）。

negative_tagsstring

避けたいスタイル。audio_operation が add-instrumental の場合は必須です。

actionstring

任意の MUSIC または LYRICS。対応する公開操作をサポートするモデルを選んでください。このフィールドで音楽専用モデルに歌詞生成機能を追加することはできません。

mvstring

Suno バージョンの指定。生成、upload-cover、upload-extend、add-instrumental、audio_url を使った置換では必須です。歌詞、task_id + audio_id を使った置換、音源分離では省略してください。対応値: chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5.

make_instrumentalboolean

true にするとボーカルなしのインストゥルメンタルを生成します。

audio_urlstring

公開アクセス可能な参照またはアップロード済み音声 URL。audio_operation を省略すると upload-cover フローを使います。

audio_operationstring

音声操作: upload-cover, upload-extend, add-instrumental, replace-section, vocal-separate, multi-stem-separation, advanced-split.

vocal-separate、multi-stem-separation、advanced-split は task_id + audio_id が必要です。advanced-split は stem_name も必要です。upload-extend は 0 より大きい continue_at、add-instrumental は audio_url、title、tags、negative_tags が必要です。

replace-section では prompt、tags、title、infill_start_s、infill_end_s、full_lyrics が必要です。ソースは task_id + audio_id または audio_url + mv のどちらか一方のみを指定します。置換区間は 6～60 秒です。

task_idstring

生成音声の置換や音源分離に使う、自分の組織が所有するソースタスク ID。

audio_idstring

ソースタスクの結果が返す音声 ID。生成音声の置換と音源分離では task_id とともに必要です。

infill_start_snumber

置換開始時刻（秒）。0 以上。replace-section で必須です。

infill_end_snumber

置換終了時刻（秒）。replace-section で必須で、infill_start_s の 6～60 秒後に指定します。

full_lyricsstring

完成する曲の歌詞全体。replace-section で必須です。

stem_namestring

分離するステム名。advanced-split で必須です。

continue_clip_idstring

続きから開始する前のクリップのID。

continue_atnumber

続きを開始する秒数。upload-extend では必須で、0 より大きい値です。

prompt は最大 5000 文字、tags と negative_tags は各最大 1000 文字です。対応する操作とパラメーターは選択したモデルの現在の詳細に従います。

レスポンス

idstring

ステータスをポーリングするためのタスクID。

task_idstring

同じ非同期タスク ID の別名。返される場合のみ存在します。

poll_urlstring

利用可能な場合に返される優先ポーリング URL です。

statusstring

タスクのステータス：pending、processing、completed、または failed。

createdinteger

返される場合のタスク作成 Unix タイムスタンプ。

リクエスト

curl -X POST "https://api.tokenlab.sh/v1/music/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-music",
    "mv": "chirp-v4",
    "prompt": "An upbeat electronic dance track with heavy bass",
    "title": "Night Drive",
    "tags": "electronic, EDM, energetic"
  }'

レスポンス

Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "suno-music"
}

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

ヘッダー

X-TokenLab-Delivery-Policy?string

リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。自動的にまず TokenLab Verified を試行し、出力、リクエストの受け入れ、または永続的なリソース作成の前に、一度だけ Official に切り替える場合があります。

指定できる値

  • "auto"
  • "verified"
  • "official"

リクエストボディ

application/json

レスポンス

application/json

application/json

Realtime WebSocket

前へ

音楽生成ステータスの取得

次へ