音楽

音楽の作成

音楽、歌詞、またはサウンド生成タスクを作成します

POST
/v1/music/generations

現在の音楽モデルを取得するには、GET /v1/models?recommended_for=music を使用してください。

AIを使用して音楽、歌詞、サウンドを生成します。これは非同期APIです。作成リクエストのレスポンスとしてタスクIDが返されます。ステータスを確認するには、そのIDを使用して GET /v1/tasks/{id} をポーリングしてください。

モデルによって受け入れ可能なフィールドが異なります。オプションフィールドを送信する前に GET /v1/models/{model} を確認してください。モデルに記載されていないフィールドを送信すると、400 unsupported_parameter が返される場合があります。Sunoフィールド(mv、title、tags、negative_tags、audio_operation、およびそれらに関連するフィールド)はSunoモデルに適用されます。user はサポートされておらず、400 が返されます。

リクエストボディ

modelstringデフォルト: suno-music

suno-music や stable-audio-3 などの音楽モデルID。明示的に指定してください。歌詞のみを生成する場合は、現在の公開操作に lyrics が含まれているモデルを選択してください。

promptstring

音楽の説明または置き換えテキスト。music、lyrics、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 からの置き換えでは必須です。lyrics、task_id + audio_id からの置き換え、ステム分離では省略してください。指定可能な値: chirp-v6、chirp-v6-mini、chirp-v6-wild。

make_instrumentalboolean

ボーカルのないインストゥルメンタル出力を生成する場合は true に設定します。

audio_urlstring

公開アクセス可能な参照用またはアップロードされたオーディオのURL。audio_operation を指定せずに指定した場合、TokenLab は 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 のいずれか1つのみを選択してください。置き換え間隔は 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より大きい必要があります。

durationinteger

生成されるオーディオの長さ(秒単位、1〜380)。stable-audio-3 など、このパラメータが記載されているモデルでのみ有効です。モデルの詳細に固有の制限値が記載されています。

output_formatstring

モデルによってリストされるオーディオファイル形式(例: mp3、wav、flac)。この形式をリストするモデルでのみ使用可能です。

seedinteger

再現可能な出力のためのシード値(0〜4294967294)。このパラメータが記載されているモデルでのみ有効です。

stepsinteger

生成ステップ数。範囲はモデルによって異なります(例: stable-audio-3 の場合は4から8)。このパラメータをリストしているモデルでのみ使用可能です。

一部のモデルでは、negative_prompt、n、seconds、guidance_scale などの追加フィールドがリストされています。これらはモデルの詳細に記載されている場合にのみ送信してください。選択したモデルが受け付けないフィールドを送信すると 400 エラーが返されます。

cfg_scalenumber

プロンプトガイダンス強度(1〜25)。このパラメータが記載されているモデルでのみ有効です。

prompt は最大5000文字まで受け付けます。tags および negative_tags はそれぞれ最大1000文字まで受け付けます。サポートされる操作およびパラメータは、選択したモデルの現在の詳細によって異なります。

レスポンス

idstring

ステータスポーリング用のタスクID。

task_idstring

返却される場合、同一の非同期タスクIDのエイリアス。

poll_urlstring

このタスクのステータスURL。id を使用して GET /v1/tasks/{id} をポーリングしてください。

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-v6",
    "prompt": "An upbeat electronic dance track with heavy bass",
    "title": "Night Drive",
    "tags": "electronic, EDM, energetic"
  }'

Sunoフィールドの代わりに duration と output_format を受け取るモデルのサウンド生成例:

{
  "model": "stable-audio-3",
  "prompt": "Warm lo-fi beat with soft vinyl crackle",
  "duration": 30,
  "output_format": "mp3"
}

レスポンス

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"
Idempotency-Key?string

作成リクエストを安全に再試行するためのオプションのキー。タスクごとに新しい一意の値(UUIDなど)を送信してください。同じキーとボディで再試行すると、元の作成リクエストの結果(通常は元のタスク)が返され、2つ目のタスクの作成、ディスパッチ、課金は行われません。すでに受け入れられたキーで異なるボディを指定すると、409で拒否されます。255文字を超えるキーは無視され、そのリクエストには冪等性保護が適用されません。詳細は冪等性キーを使用した安全な再試行を参照してください。

長さ1 <= length <= 255

リクエストボディ

application/json

レスポンス

application/json

application/json

application/json

application/json

application/json

application/json