音楽
音楽の作成
音楽、歌詞、またはサウンド生成タスクを作成します
現在の音楽モデルを取得するには、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 が返されます。
リクエストボディ
suno-musicsuno-music や stable-audio-3 などの音楽モデルID。明示的に指定してください。歌詞のみを生成する場合は、現在の公開操作に lyrics が含まれているモデルを選択してください。
音楽の説明または置き換えテキスト。music、lyrics、upload-cover、upload-extend、replace-section では必須です。add-instrumental およびステム分離では任意です。
生成される楽曲のタイトル。
スタイルタグ(例: "pop, upbeat, electronic")。
除外するスタイル。audio_operation が add-instrumental の場合は必須です。
任意の MUSIC または LYRICS の値。対応する公開操作をサポートするモデルを選択してください。このフィールドを指定しても、音楽専用モデルに歌詞のサポートが追加されるわけではありません。
Sunoバージョンセレクター。通常の生成、upload-cover、upload-extend、add-instrumental、および audio_url からの置き換えでは必須です。lyrics、task_id + audio_id からの置き換え、ステム分離では省略してください。指定可能な値: chirp-v6、chirp-v6-mini、chirp-v6-wild。
ボーカルのないインストゥルメンタル出力を生成する場合は true に設定します。
公開アクセス可能な参照用またはアップロードされたオーディオのURL。audio_operation を指定せずに指定した場合、TokenLab は upload-cover フローを使用します。
オーディオ操作: 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 秒である必要があります。
生成済みオーディオの置き換えまたはステム分離に使用する、組織に属するソースタスクID。
ソースタスクの結果で返されたソースオーディオID。生成済みオーディオの置き換えおよびステム分離では task_id と共に必須です。
置き換え開始時間(秒単位、0以上)。replace-section では必須です。
置き換え終了時間(秒単位)。replace-section では必須です。infill_start_s から 6〜60 秒後の時間である必要があります。
生成される楽曲の完全な歌詞。replace-section では必須です。
ステム名。advanced-split では必須です。
続きを生成する元のクリップID。
続きを開始する時間(秒単位)。upload-extend では必須であり、0より大きい必要があります。
生成されるオーディオの長さ(秒単位、1〜380)。stable-audio-3 など、このパラメータが記載されているモデルでのみ有効です。モデルの詳細に固有の制限値が記載されています。
モデルによってリストされるオーディオファイル形式(例: mp3、wav、flac)。この形式をリストするモデルでのみ使用可能です。
再現可能な出力のためのシード値(0〜4294967294)。このパラメータが記載されているモデルでのみ有効です。
生成ステップ数。範囲はモデルによって異なります(例: stable-audio-3 の場合は4から8)。このパラメータをリストしているモデルでのみ使用可能です。
一部のモデルでは、negative_prompt、n、seconds、guidance_scale などの追加フィールドがリストされています。これらはモデルの詳細に記載されている場合にのみ送信してください。選択したモデルが受け付けないフィールドを送信すると 400 エラーが返されます。
プロンプトガイダンス強度(1〜25)。このパラメータが記載されているモデルでのみ有効です。
prompt は最大5000文字まで受け付けます。tags および negative_tags はそれぞれ最大1000文字まで受け付けます。サポートされる操作およびパラメータは、選択したモデルの現在の詳細によって異なります。
レスポンス
ステータスポーリング用のタスクID。
返却される場合、同一の非同期タスクIDのエイリアス。
このタスクのステータスURL。id を使用して GET /v1/tasks/{id} をポーリングしてください。
タスクステータス: pending、processing、completed、または failed。
返却される場合、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"
}レスポンス
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"model": "suno-music"
}認証
BearerAuth APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
ヘッダー
リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。自動的にまず TokenLab Verified を試行し、出力、リクエストの受け入れ、または永続的なリソース作成の前に、一度だけ Official に切り替える場合があります。
指定できる値
- "auto"
- "verified"
- "official"
作成リクエストを安全に再試行するためのオプションのキー。タスクごとに新しい一意の値(UUIDなど)を送信してください。同じキーとボディで再試行すると、元の作成リクエストの結果(通常は元のタスク)が返され、2つ目のタスクの作成、ディスパッチ、課金は行われません。すでに受け入れられたキーで異なるボディを指定すると、409で拒否されます。255文字を超えるキーは無視され、そのリクエストには冪等性保護が適用されません。詳細は冪等性キーを使用した安全な再試行を参照してください。
1 <= length <= 255リクエストボディ
application/json
レスポンス
application/json
application/json
application/json
application/json
application/json
application/json