メインコンテンツへスキップ
Model logo

Suno Extend API

    Suno ExtendはSunoモデルファミリーの一部ですすべてのSunoモデルを見る

    モデル

    出力

    生成されたaudioがここに表示されます

    更新

    Suno Extendとは

    Suno Extendは、曲を長くするためのエンドポイントです。ソースとなるトラックとタイムスタンプを渡すと、その地点から同じスタイルで続く新しい音楽を書き足します。ソースには、clip_idで参照する以前のSuno楽曲生成のクリップ、またはaudio_urlとして渡す自分でホストしている任意の音声ファイルを使えます。必須のcontinue_atフィールドが新しい素材の開始秒を決めるため、印象的なイントロを残して最初のサビ以降を書き直したり、短いデモに3番とアウトロを足したりできます。続きの方向性は、短い説明(Simpleモード)か、自分で書いた歌詞とセクションタグ(Customモード)で指示します。ジョブはUnificAlly上の他のSuno操作と同じく非同期で実行され、完了すると延長されたトラックを返します。

    Suno Extendの主な機能

    延長リクエストの挙動は、次の4点で決まります。

    continue_atで任意の秒数から開始

    continue_atは必須で、小数の秒数を受け付けるため、ダウンビートぴったりで切り替えられます(例:99.6)。ソースはその地点まで再生され、そこから新しいセクションが引き継ぎます。

    Sunoのクリップでも自分の音声でも

    以前のSuno生成のクリップを続けるならclip_idを、自分でホストしているファイルを続けるならaudio_urlを渡します。リクエストの形はどちらも同じなので、生成した素材もアップロードした素材も1つのコードパスで扱えます。

    説明するか、自分で書くか

    Simpleモードはgpt_description_promptに1行の指示を受け取ります。Customモードは[Verse 3]や[Outro]のようなタグ付きの実際の歌詞をpromptに受け取るため、新しいセクションで何を歌わせるかを制御できます。

    バージョン選択、インストゥルメンタルフラグ、カスタムスタイル

    mvでchirp-hawk、chirp-hawk-wild、chirp-gooseを選び、ボーカルなしで続けるならmake_instrumentalを設定し、新しいバージョンにtitleを付けられます。mvをchirp-customにして6〜24曲のリファレンストラックのcustom_modelを渡すと、自分の楽曲のスタイルで延長されます。

    向いている用途

    • 終わりが早すぎる曲

      生成されたクリップは、曲が完結したと感じる前に止まってしまうことがよくあります。最後の印象的な小節から延長して、足りないブリッジとアウトロを追加できます。

    • 後半の書き直し

      気に入ったイントロを残し、うまくいかなかった部分の直前にcontinue_atを設定すれば、そこから新しいセクションが始まります。

    • 動画用の音楽を長くする

      ループさせたり新しい曲を作ったりする代わりに、キューをシーン全体をカバーする長さまで伸ばせます。

    • 自分のデモの仕上げ

      ラフなスケッチをaudio_urlでアップロードし、同じスタイルで次のセクションをSunoに書かせられます。

    • 長尺のインストゥルメンタルBGM

      make_instrumentalをオンにすれば、ポッドキャスト、配信、ゲーム用のBGMをボーカルが入ることなく延長できます。

    ユースケース

    作曲アプリなら、ユーザーが波形上の位置を選び、その位置をcontinue_atとして送って、延長版を元の曲と並べて表示できます。動画編集ソフトなら、タイムラインの長さを測り、音楽とカットの間のギャップを見つけて、ぴったり収まるまでサウンドトラックを延長できます。ゲームスタジオなら、同じモチーフから長めの戦闘用や探索用のバリエーションを作るために、転換点でテーマを延長できます。すでにSuno楽曲生成APIで曲を生成しているチームは、2つの呼び出しを連結できます。クリップを生成してclip_idを保持し、2回目のリクエストでCustomモードの新しいバースを付けて延長する、という流れです。

    Suno Extend APIの使用例

    パラメータの詳細はdocs.unifically.com/models/audio/suno/extendに掲載しています。

    curl -X POST https://api.unifically.com/v1/tasks \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -d '{
        "model": "suno-ai/extend",
        "input": {
          "mv": "chirp-hawk",
          "custom": false,
          "clip_id": "69ad968a-23c4-40e0-9cdc-80f9649c5209",
          "continue_at": 99.6,
          "gpt_description_prompt": "Continue the epic chorus"
        }
      }'
    

    リクエストはtask_idを返します。ステータスがcompletedになるまでGET /v1/tasks/<task_id>をポーリングするか、callback_urlを渡して、準備ができたときに延長されたトラックをサーバーに送信させてください。

    FAQ

    Suno Extendに関するよくある質問

    既存の音声を、指定した地点から続けて生成します。秒数でcontinue_atを送り、あわせて以前のSuno生成のclip_idか、自分でホストしているファイルのaudio_urlを渡すと、ジョブはその地点から曲を引き継ぐ新しい音声を返します。

    どちらでも使えます。以前のSunoジョブから得たクリップならclip_idを、自分でホストしている任意の音声ファイルならaudio_urlを渡してください。送るのはどちらか一方で、両方は指定できません。

    秒単位の数値で小数も受け付けるため、99.6のような値も有効です。新しいセクションを始めたい小節やフレーズの位置に設定してください。

    customをfalseにすると、gpt_description_promptで続きの内容を説明します(例:「Continue the epic chorus」)。customをtrueにすると、[Verse 3]や[Bridge]のようなセクションタグを使って、実際の歌詞や構成をpromptに書きます。

    Chirpの3バージョンです。chirp-hawk(v6)、chirp-hawk-wild(v6 Wild、より実験的な結果向け)、chirp-goose(v6 Mini、より高速で軽量)です。また、mvをchirp-customにして、名前と6〜24個のリファレンス音声URLを含むcustom_modelオブジェクトを渡せば、自分のトラックのスタイルで延長できます。

    はい。make_instrumentalをtrueにすると、続きの部分がボーカルなしで返ってきます。伴奏トラックや劇伴のキューを長くしたいときに便利です。