作り直さずに曲を延長
Extend Song API は、すでに生成したトラックを継続します。origin_task_id で完了した生成を指定し、extend_audio_index で返された 2 つの音声のどちらを継続するか選ぶと、プラットフォームがソースの終わりから続く新しいセグメントを作曲します。
2 つのモードが一般的なワークフローをカバーします。継承モード（custom_mode: false）は元のパラメータを再利用し、気に入ったテイクを伸ばす最速の方法です。カスタムモード（custom_mode: true）は新しい prompt・style・title・extensionStartTime を受け付け、アレンジを転換できます — 例えば高エネルギーのサビを静かなアウトロへ。
クイックスタート：延長してポーリング
ソースタスクを指定して /v2/extend に POST し、/v2/feed?workId=... をポーリングするか、callback_url で webhook を受け取ります。
curl -X POST "https://udioapi.pro/api/v2/extend" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"origin_task_id": "gen20e094aeaadfe494ea33a5c80ee596083bksv",
"extend_audio_index": 0,
"custom_mode": true,
"prompt": "Change the music style to be calm and lyrical.",
"style": "lyrical"
}'
curl -X GET "https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID"extensionStartTime は任意です。値は 1 …（ソース再生時間 − 1）秒に丸められ、未指定時はソース終端から延長されます。
延長リクエストパラメータ
延長は元トラックのモデル価格で課金されます。chirp-v5・chirp-v5-5 で作ったトラックは chirp-v6 が、それより古いレガシーモデルのトラックは chirp-v6-mini が延長します。
| パラメータ | 型 | 必須 | 備考 |
|---|---|---|---|
| origin_task_id | string | 必須 | 元の生成リクエストの task_id |
| extend_audio_index | number | 必須 | 延長する返却音声：0 または 1 |
| custom_mode | boolean | 任意 | false はソースパラメータを継承（デフォルト）、true でカスタム項目を有効化 |
| prompt | string | カスタムモード | 新しい歌詞または説明、5000 文字以内 — 超過分は切り詰め |
| style | string | 任意 | 継続部分のスタイル、1000 文字以内 — 切り詰め |
| title | string | 任意 | 延長トラックのタイトル、80 文字以内 — 切り詰め |
| extensionStartTime | number | 任意 | 開始点（秒）。1 …（ソース再生時間 − 1）に丸め |
| callback_url | string | 任意 | 最終結果を受け取る公開 HTTPS webhook |
拒否・失敗した延長は自動返金 — 422 レスポンスは修正すべきパラメータを示し、受理後の失敗は feed で FAILED として表示されクレジットが戻ります。
構築できるもの
延長は音声 API の他の部分と組み合わせられます。
より長いアレンジ
延長を連鎖させ、元の長さを超えるイントロ・バース・アウトロを構築。
ドキュメントを読むエンディングを変える
カスタムモードで新しいプロンプトとスタイルが継続の行き先を操ります。
ドキュメントを読むまずソースを生成
/v2/generate で延長したいトラックを作成 — chirp-v6 ファミリーは両エンドポイントで動作。
ドキュメントを読む自分の音声のカバー
アップロードから始めたい場合は upload-cover エンドポイントが対応します。
ドキュメントを読むタイムスタンプ付き歌詞
延長結果の行単位の歌詞タイミングを取得します。
ドキュメントを読むコールバックとポーリング
/v2/feed ポーリングまたは callback_url webhook で完了を受け取ります。
ドキュメントを読む使い方
完了した生成から長いトラックまで、4 ステップ。
- 1
ソーストラックを生成
/v2/generate で曲を作成し SUCCESS を待ちます。task_id を保存し音声インデックスを選びます。
- 2
延長を送信
origin_task_id・extend_audio_index・任意のカスタム項目で /v2/extend に POST。
- 3
ポーリングかコールバック
5〜10 秒ごとに GET /v2/feed?workId=... を呼ぶか、callback_url で webhook を受け取ります。
- 4
音声をダウンロード
SUCCESS になると feed に延長音声の URL が入ります。自分のストレージに保存してください。
制限と注意点
- 完了したソースタスクが必要で、extend_audio_index は 0 か 1 を選びます — 多くの生成は 2 つの音声を返します。
- 延長はソースモデルの価格を継承。chirp-v5/chirp-v5-5 トラックは chirp-v6 が、古いレガシートラックは chirp-v6-mini が延長します。
- 長すぎる prompt・style・title は拒否ではなく切り詰められます。
- extensionStartTime はリクエストを失敗させず有効範囲に丸められます。
- 音声 URL は一時的です。結果は自分のストレージにダウンロードしてください。
udioapi.pro は独立したサードパーティサービスです。Suno、Udio、MiniMax とは提携しておらず、これらによる承認・運営も受けていません。
Extend Song API よくある質問
モード・課金・非同期ワークフローへの回答。
Extend Song API は何をしますか？
完了した生成を元の終端の先へ継続します。継承モードはソースパラメータを再利用し、カスタムモードは新しい prompt・style・title・extensionStartTime を受け付けます。
延長の課金方法は？
元トラックのモデル価格でリクエスト単位に課金されます。chirp-v6 が処理したトラックの延長も同じ 12 クレジット、chirp-v6-mini は 10 クレジット。拒否・失敗した延長は自動返金です。
どの音声を延長すればいいですか？
extend_audio_index を 0 にすると最初の音声、1 にすると 2 番目の音声を延長します — 多くの生成リクエストは 2 バリエーションを返します。
継承モードとカスタムモードの違いは？
継承モード（custom_mode: false）は元のパラメータで継続します。カスタムモード（custom_mode: true）では新しい prompt・style・title が継続を操ります。
extensionStartTime が範囲外だと？
失敗せず 1 …（ソース再生時間 − 1）秒に丸められます。未指定・無効な値はソース終端から延長します。
延長が失敗したらクレジットは？
かかりません。検証で拒否されたリクエストは 422 を返し、受理後に失敗したタスクは feed で FAILED になります — どちらもクレジットは返金されます。