> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Suno 歌曲生成 API 対接説明 > Suno Music Generation API guide - Ace Data Cloud AIの応用が広がるにつれて、さまざまなAIプログラムが徐々に普及しています。AIは人々の仕事や生活のあらゆる面に深く浸透しています。そして、AIが関与する業界もますます増えています。最初のライティングから、医療教育、そして現在の音楽へと至ります。 Sunoは、専門的で高品質なAIの歌と音楽創作プラットフォームで、ユーザーは簡単なテキストプロンプトを入力するだけで、ジャンルスタイルや歌詞に基づいてボーカル付きの曲を生成できます。このAI音楽生成器は、Meta、TikTok、Kenshoなどの著名なテクノロジー企業のチームメンバーによって開発されており、楽器やツールを必要とせず、誰でも素晴らしい音楽を創造できることを目指しています。 以下はモデル更新の進捗です： | バージョン | model | リリース日 | lyric 制限 | style 制限 | 曲の最長時間 | | ----- | --------------- | ---------- | -------- | -------- | ------ | | v5.5 | chirp-v5-5 | 2026.03.27 | 5000 | 1000 | 8 分 | | v5 | chirp-v5 | 2025.09.23 | 5000 | 1000 | 8 分 | | v4.5+ | chirp-v4-5-plus | 2025.07.17 | 5000 | 1000 | 8 分 | | v4.5 | chirp-v4-5 | 2025.05.03 | 5000 | 1000 | 4 分 | | v4 | chirp-v4 | 2024.12.17 | 3000 | 200 | 150 秒 | | v3.5 | chirp-v3-5 | --- | 3000 | 200 | 120 秒 | > 上表の `lyric` と `style` 制限はカスタムモード（`custom` が `true`）下の上限です。非カスタムのインスピレーションモード（`custom` が `false`）では、`prompt` のみを記入し、その長さの上限は500文字（各モデル共通）です。 Sunoは現在最新の `chirp-v5-5` モデルをサポートしています。最新バージョンを呼び出す際は、`model` パラメータを `chirp-v5-5` に設定するだけです；`chirp-v5` およびそれ以前のバージョンも引き続き使用可能です。 しかし、Suno公式はAPIを提供していません。AceDataCloudはSunoのAPIを提供しており、公式に接続を模倣し、希望する音楽を簡単かつ迅速に生成できます。 ## 申請と使用 Suno Audios Generation APIを使用するには、まず [Ace Data Cloud コントロールセンター](https://platform.acedata.cloud/console/applications) にアクセスしてAPIトークンを取得し、保管してください。 ![](https://cdn.acedata.cloud/dvc3cg.jpg) まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。 **1つのAPIトークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。** 初回申請時には無料のクレジットが付与され、無料で体験できます；クレジットが不足した場合は、[コントロールセンター](https://platform.acedata.cloud/console/coin) で一般残高をチャージできます。 > 📘 完全なドキュメント：[Suno Audios Generation API →](https://platform.acedata.cloud/documents/suno-audios) ## 基本使用 どんな曲を作りたいか、任意のテキストを入力できます。例えば、クリスマスに関する曲を生成したい場合は、`a song for Christmas` と入力できます。以下のように：

ここでは、リクエストヘッダーを設定しました。内容は以下の通りです： * `accept`：どのような形式のレスポンスを受け取りたいか、ここでは `application/json`、つまりJSON形式を記入します。 * `authorization`：APIを呼び出すためのキーで、申請後に直接選択できます。 さらに、リクエストボディを設定しました。 * `action`：今回の音楽生成タスクの行動、デフォルトは `generate`、主に含まれるのは：`extend`、`upload_extend`、`cover`、`upload_cover`、`replace_section`、`replace_section`、`concat`、`stems`、`all_stems`、`remaster`。 * `prompt`：Suno公式のインスピレーションモードのヒントワード（`custom` が `false` の場合に有効）、最大500文字。 * `model`：今回の音楽生成タスクのモデル、デフォルトは `chirp-v4`、主に含まれるのは：`chirp-v3`、`chirp-v4`、`chirp-v3-5`、`chirp-v4-5`、`chirp-v4-5-plus`、`chirp-v5`、`chirp-v5-5`。 * `lyric`：Suno公式のカスタムモードの歌詞内容。`chirp-v3-5` と `chirp-v4` は最大3000文字；`chirp-v4-5` 及びそれ以上（含む `chirp-v5`、`chirp-v5-5`）は最大5000文字。 * `custom`：カスタムモードを使用するかどうか、デフォルトは: `false`。 * `instrumental`：Suno公式のインスピレーションモードの純音楽オプション。 * `title`：Suno公式のカスタムモードの音楽タイトル。`chirp-v3-5`、`chirp-v4` は最大80文字；`chirp-v4-5` 及びそれ以上は最大100文字。 * `style`：Suno公式のカスタムモード音楽スタイル。`chirp-v3-5` と `chirp-v4` は最大200文字；`chirp-v4-5` 及びそれ以上（含む `chirp-v5`、`chirp-v5-5`）は最大1000文字。 * `negative_tags`：カスタムモード（`custom` が `true` の場合）で生成結果から除外したい音楽スタイルやジャンル。 * `audio_weight`：アップロードした参考音声の比率、範囲は0-1、数値が大きいほど参考音声に依存する。 * `audio_id`：参考音楽のID。 * `overpainting_start`/`overpainting_end`：既存の純音楽にボーカルを追加する開始・終了時間、単位は秒。 * `underpainting_start`/`underpainting_end`：アカペラに伴奏を加える開始・終了時間、単位は秒。 * `persona_id`：アーティストの曲のID。 * `continue_at`：続きの生成境界、単位は秒。例えば、213.5は3分33.5秒から後続の部分を生成することを示す。`lyric` と `style` は境界以降の新しい内容を導くが、境界以前の元音声の歌詞や演唱を置き換えることはない。 * `style_influence`：カスタムモードの「Style Influence」高度なパラメータ、範囲は0-1、数値が大きいほど選択したスタイルに近づく。 * `replace_section_end`：置き換えセクションの最終時間。 * `replace_section_start`：置き換えセクションの開始時間。 * `vocal_gender`：男女声の好みを制御、女性声は `f`、男性声は `m`、4.5以上のモデルで有効；好みの項目であり、厳密に遵守されることは保証されない。 * `weirdness`：カスタムモードの「Weirdness」高度なパラメータ、範囲は0-1、数値が大きいほど創造的で実験的。 * `duration`：期待する曲の長さ、単位は秒、整数でなければならず、範囲は10から360。これはカスタムモード（`custom` が `true` の場合）の曲生成に使用される。これは傾向を示すヒントであり、厳密な制約ではない：モデルはこれを参考にするが、達成を保証するものではなく、実際の成果物の長さは応答の `duration` フィールドに基づく、通常は期待値より短い。 * `lyric_prompt`：歌詞を生成するためのプロンプト、`custom` が `true` で `lyric` が提供されていない場合にのみ有効。 * `callback_url`：結果をコールバックする必要があるURL。 * `async`：オプション、`true` に設定するとインターフェースは即座に `task_id` を返し、`callback_url` を提供する必要がなく、その後対応するタスククエリインターフェースを通じて結果をポーリングして取得する。 生成されたコードは以下の通りです：

「Try」ボタンをクリックしてAPIを直接テストできます。1-2分待つと、結果は以下の通りです： ```json theme={null} { "success": true, "task_id": "e72fb249-bd5b-4e2a-b20c-8a06fea5ac14", "trace_id": "7dbc5b6a-b2c0-4d85-9d39-fa8a8a785ccf", "data": [ { "id": "b481b17a-bf50-4e10-8adc-4d5635050893", "title": "ミスルトウの下で", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-001", "lyric": "[Verse]\n雪の結晶が地面に落ちる\n周りに輝く光\n松の香りが空気を満たす\nクリスマスの魔法がどこにでも\n[Chorus]\n今夜ミスルトウの下で\n柔らかな月明かりの中で心が輝く\n笑い声が響く\n明るい気持ち\nクリスマスの時期\nとても素晴らしい\n[Verse 2]\n暖炉の光のそばに吊るされた靴下\n寒い風が吹く中での温かさ\nクッキーが焼かれている\n甘い喜び\n輝く喜びの季節\n[Chorus]\n今夜ミスルトウの下で\n柔らかな月明かりの中で心が輝く\n笑い声が響く\n明るい気持ち\nクリスマスの時期\nとても素晴らしい\n[Bridge]\nキャンドルの光で歌われるキャロル\n上の星々が世界を引き締める\n平和と愛\n季節の信条\n私たちに必要なものを心に満たす\n[Chorus]\n今夜ミスルトウの下で\n柔らかな月明かりの中で心が輝く\n笑い声が響く\n明るい気持ち\nクリスマスの時期\nとても素晴らしい", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-17T15:59:32.468Z", "model": "chirp-auk", "state": "succeeded", "prompt": "クリスマスのための歌", "style": "ホリデー、陽気、男性ボーカル", "duration": 154.92 }, { "id": "fbf22dab-5e2b-4e02-84c0-6d7605f14c3d", "title": "ミスルトウの下で", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-002", "lyric": "[Verse]\n雪の結晶が地面に落ちる\n周りに輝く光\n松の香りが空気を満たす\nクリスマスの魔法がどこにでも\n[Chorus]\n今夜ミスルトウの下で\n柔らかな月明かりの中で心が輝く\n笑い声が響く\n明るい気持ち\nクリスマスの時期\nとても素晴らしい\n[Verse 2]\n暖炉の光のそばに吊るされた靴下\n寒い風が吹く中での温かさ\nクッキーが焼かれている\n甘い喜び\n輝く喜びの季節\n[Chorus]\n今夜ミスルトウの下で\n柔らかな月明かりの中で心が輝く\n笑い声が響く\n明るい気持ち\nクリスマスの時期\nとても素晴らしい\n[Bridge]\nキャンドルの光で歌われるキャロル\n上の星々が世界を引き締める\n平和と愛\n季節の信条\n私たちに必要なものを心に満たす\n[Chorus]\n今夜ミスルトウの下で\n柔らかな月明かりの中で心が輝く\n笑い声が響く\n明るい気持ち\nクリスマスの時期\nとても素晴らしい", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-17T15:59:32.468Z", "model": "chirp-auk", "state": "succeeded", "prompt": "クリスマスのための歌", "style": "ホリデー、陽気、男性ボーカル", "duration": 158.48 } ] } ``` この時点で、私たちは2曲の内容を得ました。タイトル、プレビュー画像、歌詞、音声、動画などの内容が含まれています。 フィールドの説明は以下の通りです： * success：生成が成功したかどうか、成功した場合は `true`、そうでなければ `false` * data：生成された曲の詳細情報を含むリスト。 * state：曲の生成状態、主に4種類が含まれます。具体的には以下の通り： * succeeded：生成成功 * pending：キュー中 * running：実行中 * error：失敗 * id：曲のID * title：曲のタイトル * image\_url：曲のカバー画像 * lyric：曲の歌詞 * audio\_url：曲の音声ファイル、開くとmp3音声になります。 * video\_url：曲の動画ファイル、開くとmp4動画になります。 * created\_at：作成日時 * model：使用されたモデル、一般的には最新のv3モデル * style：スタイル ## カスタム生成 歌詞をカスタム生成したい場合は、歌詞を入力できます： この時、 `lyric` フィールドには以下のような内容を渡すことができます： ``` [Verse]\n雪の結晶が周りに落ちる\n輝く白\n地面を覆う\n子供たちが笑っている\n喜びに満ちて\n今夜この冬のワンダーランドで\nサンタのそり\n空に上がって\nルドルフの鼻が明るく輝く\nおお、私\n鈴の音が聞こえる\nはっきりと鳴って\n喜びとホリデーの楽しさをもたらす\n[Verse 2]\n暖炉の光のそばで焼かれる栗\nクリスマスの光\nそれらはきらめいて見せる\n家族が愛と楽しさで集まる\n近くのすべての人に温かさを広げる ``` > 注意：ここでの歌詞中の `\n` は改行文字です。歌詞を生成する方法がわからない場合は、AceDataCloudが提供する歌詞生成APIを使用して、プロンプトを通じて歌詞を生成できます。APIは [Suno Lyrics Generation API](https://platform.acedata.cloud/documents/suno-lyrics) です。 次に、歌詞、タイトル、スタイルに基づいて曲をカスタム生成するために、以下の内容を指定できます： * lyric：歌詞テキスト * custom： `true` と記入し、カスタム生成を示します。このパラメータはデフォルトでfalseで、プロンプト生成を示します。 * title：曲のタイトル。 * style：曲のスタイル、任意。 記入例は以下の通りです：

記入が完了すると、自動的に以下のコードが生成されます：

対応するコード： ```shell theme={null} curl -X POST 'https://api.acedata.cloud/suno/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "generate", "prompt": "クリスマスのための歌", "model": "chirp-v4-5", "lyric": "[Verse]\\n雪の結晶が周りに落ちる\\n輝く白\\n地面を覆う\\n子供たちが笑っている\\n喜びに満ちて\\n今夜この冬のワンダーランドで\\nサンタのそり\\n空に上がって\\nルドルフの鼻が明るく輝く\\nおお、私\\n鈴の音が聞こえる\\nはっきりと鳴って\\n喜びとホリデーの楽しさをもたらす\\n[Verse 2]\\n暖炉の光のそばで焼かれる栗\\nクリスマスの光\\nそれらはきらめいて見せる\\n家族が愛と楽しさで集まる\\n近くのすべての人に温かさを広げる", "custom": true }' ``` テストが許可され、生成された効果は似たようなものです。 ## カスタム歌手スタイル生成機能 もし歌手のスタイルを使用して曲を生成したい場合、まずは上記の基本的な使用法を通じて曲を生成し、最後にこの曲を歌手のスタイルに設定する必要があります。そのためには、[Suno Persona API](https://platform.acedata.cloud/documents/suno-persona)にアクセスし、公式に生成された音楽ID `audio_id` を使用して歌手スタイルのIDパラメータ `persona_id` を生成する必要があります。具体的なパラメータは以下の図の通りです：

記入が完了した後、自動生成されたコードは以下の通りです：

対応するPythonコード： ```python theme={null} import requests url = "https://api.acedata.cloud/suno/persona" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "audio_id": "97efc9f4-0e8d-4b3e-88df-14568fa1b11f", "name": "test" } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` 実行をクリックすると、以下のような結果が得られます： ```json theme={null} { "success": true, "task_id": "7628b754-4fe7-4e79-bda4-806d0dd8bf6e", "data": { "persona_id": "e0d7319e-aa2a-44cb-b00a-916218d7cb0b" } } ``` 上記の `audio_id` と `persona_id` をそれぞれ `97efc9f4-0e8d-4b3e-88df-14568fa1b11f`、`e0d7319e-aa2a-44cb-b00a-916218d7cb0b` として、今回のサンプルデータとします。次に、パラメータ `action` を `artist_consistency` に設定します（新しい歌手スタイルのPersona-v2-voxの場合、`action` は `artist_consistency_vox` に設定する必要があります）。続けて、曲を生成するためのIDと歌手スタイルIDを入力し、以下のように記入します：

記入が完了した後、自動生成されたコードは以下の通りです：

対応するPythonコード： ```python theme={null} import requests url = "https://api.acedata.cloud/suno/audios" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "action": "artist_consistency", "prompt": "A song for Christmas", "model": "chirp-v4-5", "persona_id": "e0d7319e-aa2a-44cb-b00a-916218d7cb0b", "audio_id": "97efc9f4-0e8d-4b3e-88df-14568fa1b11f" } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` 実行をクリックすると、以下のような結果が得られます： ```json theme={null} { "success": true, "task_id": "9b732b1a-bd67-48bc-95e4-90140e06836f", "trace_id": "30fcd88e-7687-4137-92d7-913b58115204", "data": [ { "id": "727a36e2-8dce-4df7-99e5-14e44635c80f", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-003", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-17T16:27:33.979Z", "model": "chirp-auk", "state": "succeeded", "style": "", "duration": 244.4 }, { "id": "3b33301a-b17e-4b25-8842-09b46dab1a36", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-004", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-17T16:27:33.979Z", "model": "chirp-auk", "state": "succeeded", "style": "", "duration": 229.88 } ] } ``` 結果の内容が上記と一致していることがわかります。これにより、歌手のスタイルを使用して曲を生成する機能が実現されました。 ## 続けて生成する機能 既に生成されたSunoの曲を続けて生成したい場合、パラメータ `action` を `extend` に設定し、続けて生成する曲のIDを入力します。曲のIDは基本的な使用法に基づいて取得され、上記からこの時点で曲のIDは次のようになります： ``` "id": "97efc9f4-0e8d-4b3e-88df-14568fa1b11f" ``` > 注意：ここでの歌詞中の `id` は生成後の曲のIDです。曲を生成する方法がわからない場合は、上記の基本的な使用法を参考にしてください。 自分がアップロードした曲を続けて生成したい場合、パラメータ `action` を `upload_extend` に設定し、続けて生成するカスタムアップロードの曲IDを入力します。曲のIDは[Suno Upload Generation API](https://platform.acedata.cloud/documents/suno-upload)を使用して取得します。以下の図の通りです：

次に、続きの歌詞のフラグメントを記入し、スタイルを指定する必要があります： * lyric：`continue_at` の後に新しく生成されるフラグメントの歌詞を導くためだけに使用され、元の音声のその時間点以前の歌詞は置き換えられません。 * custom：`true` に設定するとカスタム生成を意味し、このパラメータはデフォルトで false で、`prompt` による生成を意味します。 * style：続きのフラグメントの曲のスタイル、任意で記入。 * continue\_at：続きの境界、単位は秒です。例えば、213.5は3分33.5秒から続きのフラグメントを生成することを示します。 > `extend` は既存の曲を続けて創作するためのものであり、全体の曲の歌詞を置き換えるためのものではありません。全体の曲を最初から新しい歌詞で生成したい場合は、`generate` を使用して再生成してください。既存の曲を参考にして再演繹したい場合は、`cover` を使用してください。新しい歌詞全体を渡すと、`continue_at` 以前の元の歌詞は置き換えられません。 記入のサンプルは以下の通りです：

記入が完了した後、自動生成されたコードは以下の通りです：

以下は、実際の歴史的な呼び出しスナップショットであり、`continue_at` は2秒であるため、最初の2秒のみが続きの境界の前の元の内容に属します。実際に曲の終わりに近い続きの部分を書く際には、この値を期待する続きの開始秒数に設定し、`lyric` には境界の後に歌う新しい段落のみを提供する必要があります。 対応するPythonコード： ```python theme={null} import requests url = "https://api.acedata.cloud/suno/audios" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "action": "extend", "prompt": "A song for Christmas", "model": "chirp-v4-5", "audio_id": "97efc9f4-0e8d-4b3e-88df-14568fa1b11f", "continue_at": 2, "lyric": "[Verse]\\nSnowflakes falling all around\\nGlistening white\\nCovering the ground\\nChildren laughing\\nFull of delight\\nIn this winter wonderland tonight\\nSanta's sleigh\\nUp in the sky\\nRudolph's nose shining bright\\nOh my\\nHear the jingle bells\\nRinging so clear\\nBringing joy and holiday cheer\\n[Verse 2]\\nRoasting chestnuts by the fire's glow\\nChristmas lights\\nThey twinkle and show\\nFamilies gathering with love and cheer\\nSpreading warmth to everyone near", "custom": True, "instrumental": False } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` 実行すると、次のような結果が得られます： ```json theme={null} { "success": true, "task_id": "75b835d9-30d1-4641-8524-0aeedbdc9e1a", "trace_id": "44c41045-a2e1-4d19-aafc-7abd239d0d5c", "data": [ { "id": "0a1e1b10-c36a-41c9-9bfb-b26d9d25db98", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-005", "lyric": "[Verse]\\nSnowflakes falling all around\\nGlistening white\\nCovering the ground\\nChildren laughing\\nFull of delight\\nIn this winter wonderland tonight\\nSanta's sleigh\\nUp in the sky\\nRudolph's nose shining bright\\nOh my\\nHear the jingle bells\\nRinging so clear\\nBringing joy and holiday cheer\\n[Verse 2]\\nRoasting chestnuts by the fire's glow\\nChristmas lights\\nThey twinkle and show\\nFamilies gathering with love and cheer\\nSpreading warmth to everyone near", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-17T16:38:35.509Z", "model": "chirp-auk", "state": "succeeded", "style": "", "duration": 165.92 }, { "id": "4334c5b4-0a44-4b26-a8f6-66cc4dbb8fc3", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-006", "lyric": "[Verse]\\nSnowflakes falling all around\\nGlistening white\\nCovering the ground\\nChildren laughing\\nFull of delight\\nIn this winter wonderland tonight\\nSanta's sleigh\\nUp in the sky\\nRudolph's nose shining bright\\nOh my\\nHear the jingle bells\\nRinging so clear\\nBringing joy and holiday cheer\\n[Verse 2]\\nRoasting chestnuts by the fire's glow\\nChristmas lights\\nThey twinkle and show\\nFamilies gathering with love and cheer\\nSpreading warmth to everyone near", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-17T16:38:35.509Z", "model": "chirp-auk", "state": "succeeded", "style": "", "duration": 158.84 } ] } ``` 結果の中で、`lyric` は今回の続きのタスクで使用された歌詞テキストを返します。このフィールドは、完全な音声の逐語的な書き起こしではありません。`extend` の場合、`continue_at` 以前の元の音声は元の歌詞を使用し、新しい歌詞は続きの部分を導くためだけに使用されます。 ## 完全な曲を取得する 現在のモデルの `extend` 結果には、通常、`continue_at` 以前の元の音声と境界の後の新しい内容が含まれています。返された音声の実際の長さと内容に基づいて、すでに完全な曲であるかどうかを判断してください。返されたのが独立した続きの部分である場合、または複数の続きの履歴を明示的に1曲に統合する必要がある場合は、結合機能を使用します： * action：内容は `concat`。 * audio\_id：最後の続きの部分のID。 例えば、拡張された曲のIDが：0a1e1b10-c36a-41c9-9bfb-b26d9d25db98 の場合、パラメータを次のように設定できます： ```json theme={null} { "action": "concat", "audio_id": "0a1e1b10-c36a-41c9-9bfb-b26d9d25db98" } ``` 他のパラメータはそのままで、返されるのは1曲の完全な曲であり、すべての曲の部分の結合結果ですが、結果は1曲のみです。例は以下の通りです： ```json theme={null} { "success": true, "task_id": "0f794915-8418-4124-93f5-b7eb3a417167", "trace_id": "62afcce0-e7e5-44b8-8c2e-4bba12a4f414", "data": [ { "id": "0efec7e0-11bf-4313-9981-2c0e7218d7dd", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-007", "lyric": "[Verse]\\n雪の結晶が周りに降り注ぎ\\n輝く白\\n地面を覆い\\n子供たちが笑い\\n喜びに満ちて\\n今夜のこの冬のワンダーランドで\\nサンタのそり\\n空に舞い上がり\\nルドルフの鼻が明るく輝く\\nおお、私\\n鈴の音が聞こえる\\nはっきりと鳴り響き\\n喜びとホリデーの楽しさをもたらす\\n[Verse 2]\\n火の光で焼き栗を焼いて\\nクリスマスのライト\\n彼らはきらめき、見せる\\n家族が愛と楽しさで集まり\\n近くのすべての人に温もりを広げる\\n[Verse]\\n雪の結晶が周りに降り注ぎ\\n輝く白\\n地面を覆い\\n子供たちが笑い\\n喜びに満ちて\\n今夜のこの冬のワンダーランドで\\nサンタのそり\\n空に舞い上がり\\nルドルフの鼻が明るく輝く\\nおお、私\\n鈴の音が聞こえる\\nはっきりと鳴り響き\\n喜びとホリデーの楽しさをもたらす\\n[Verse 2]\\n火の光で焼き栗を焼いて\\nクリスマスのライト\\n彼らはきらめき、見せる\\n家族が愛と楽しさで集まり\\n近くのすべての人に温もりを広げる", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-17T16:43:06.718Z", "model": "chirp-auk", "state": "succeeded", "style": "", "duration": 167.91997916666668, "concat_history": [ { "continue_at": 2, "id": "97efc9f4-0e8d-4b3e-88df-14568fa1b11f", "infill": false, "source": "web", "type": "gen" }, { "id": "0a1e1b10-c36a-41c9-9bfb-b26d9d25db98" } ] } ] } ``` ## 音楽翻版 元の曲に基づいて曲を生成した後、返された曲のスタイルがあまり適切でない場合があります。元の生成された曲（カスタムアップロードされた音楽もサポート）を翻版するには、音楽翻版方法を使用する必要があります。以下の内容を指定できます： * action：内容は `cover`、カスタムアップロードされた音楽に対して翻版操作を行う場合は、内容を `upload_cover` と指定する必要があります。 * audio\_id：以前に生成された曲のID。 例えば、元の生成された曲のIDが：0a1e1b10-c36a-41c9-9bfb-b26d9d25db98の場合、パラメータを以下のように設定できます： ```json theme={null} { "action": "cover", "audio_id": "0a1e1b10-c36a-41c9-9bfb-b26d9d25db98", "prompt": "クリスマスのための歌", "model": "chirp-v4-5" } ``` 他のパラメータはそのままで、返されるのは翻版された曲であり、元の生成された曲の翻版結果となります。以下のような例があります： ```json theme={null} { "success": true, "task_id": "b9d43d06-2e0a-4b5e-9e0d-7dfab32e00ab", "trace_id": "6c5e567d-0fdc-4c44-9b36-4090d9a75ff5", "data": [ { "id": "6988fa57-f810-41cf-afab-7838db2c77dc", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-008", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-17T16:44:13.007Z", "model": "chirp-auk", "state": "succeeded", "style": "", "duration": 182.4 }, { "id": "ce98b991-0258-4f05-8245-e43d4efa8fb8", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-009", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-17T16:44:13.007Z", "model": "chirp-auk", "state": "succeeded", "style": "", "duration": 179.72 } ] } ``` 生成された結果は上記のように似ており、元の生成された曲の翻版生成プロセスが完了しました。 ## 置き換えセクション 曲を生成した後、曲の特定のセクションを置き換える二次創作を行う必要がある場合、曲のあるセクションを置き換える操作を行うことができます。 > ⚠️ **注意**：`replace_section_result_mode` のデフォルトは `full_song`：システムは2つの新しく生成された候補をそれぞれ結合し、2つの完全な曲を返します。まだ結合されていない置き換えセクションの候補のみが必要な場合は、明示的に `candidates` に設定し、候補を選択して [音楽の結合](#音楽の結合) を呼び出してください。 パラメータの説明は以下の通りです： * action：内容は `replace_section`。 * audio\_id：元の曲（置き換えられる元の曲）のID。 * model: 曲生成モデル。 * lyric: 置き換え後の完全な歌詞（置き換えられるセクションとその前後の文脈を含み、`prompt` の内容と一致する）。 * prompt：置き換えが必要な新しい歌詞のその部分。 * style：曲のスタイル、任意。 * replace\_section\_start：置き換えられるセクションの元の曲における開始時間（秒）。 * replace\_section\_end：置き換えられるセクションの元の曲における終了時間（秒）。 * replace\_section\_result\_mode：返却モード、デフォルトは `full_song`。`full_song` はそれぞれ2つの候補を結合して2つの完全な曲を返します；`candidates` は2つのまだ結合されていない候補セクションを返します。 ### ステップ1：置き換えセクションタスクを開始する 例えば、元の生成された曲のIDが：18db7ed0-2b8a-41db-91c1-b0781dcca0d4（長さ94.12秒）で、第30秒から第60秒のコーラスを新しい歌詞に置き換えたい場合、パラメータを以下のように設定できます： ```` ```json { "action": "replace_section", "audio_id": "18db7ed0-2b8a-41db-91c1-b0781dcca0d4", "model": "chirp-v5-5", "custom": false, "instrumental": false, "lyric": "[Intro]\n太鼓が鳴り響き 赤いランタンが高く掲げられる\n[Verse 1]\n爆竹の音が旧年を見送る\n春風が暖かく万家に入る\nお年玉の封筒が笑顔を引き出す\n金の蛇が舞い新春を祝う\n[Chorus]\n梅の花が咲き誇り春の気配が満ち溢れる\n梅の花が咲き誇り春の気配が満ち溢れる\n梅の花が咲き誇り春の気配が満ち溢れる\n梅の花が咲き誇り春の気配が満ち溢れる\n[Verse 2]\n餃子の香りが漂う年越しの夕食\nランタンが揺れ動き団円を照らす", "prompt": "梅の花が咲き誇り春の気配が満ち溢れる\n梅の花が咲き誇り春の気配が満ち溢れる\n梅の花が咲き誇り春の気配が満ち溢れる\n梅の花が咲き誇り春の気配が満ち溢れる", "replace_section_start": 30.0, "replace_section_end": 60.0, "replace_section_result_mode": "full_song" } ```` デフォルトで2つの候補をそれぞれ2つの候補で接続した完全な曲を返します。`replace_section_result_mode`を`candidates`に設定すると、構造は以下の例と一致する2つの未接続の置換セクションが返されます： ```json theme={null} { "success": true, "task_id": "dd067075-a295-4160-8375-d5504327d55b", "trace_id": "c34f589b-9195-4d0b-af78-9c890e77609c", "data": [ { "id": "364f9d8b-ca25-463b-9a5e-d0b7139e2d6a", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-010", "image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-011", "lyric": "[Intro]\n太鼓が鳴り響き 赤いランタンが高く掲げられる\n[Verse 1]\n爆竹の音が旧年を見送る\n春風が暖かく万家に入る\nお年玉の封筒が笑顔を引き出す\n金の蛇が舞い新春を祝う\n[Chorus]\n梅の花が咲き誇り春の気配が満ち溢れる\n梅の花が咲き誇り春の気配が満ち溢れる\n梅の花が咲き誇り春の気配が満ち溢れる\n梅の花が咲き誇り春の気配が満ち溢れる\n[Verse 2]\n餃子の香りが漂う年越しの夕食\nランタンが揺れ動き団円を照らす", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2026-05-06T06:55:00.000Z", "model": "chirp-v5-5", "state": "succeeded", "style": "", "duration": 45.16 }, { "id": "fae966ea-5f7f-4e80-9962-1c57963c7f8a", "title": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "model": "chirp-v5-5", "state": "succeeded", "duration": 33.8 } ] } ``` `candidates`モードでは、返される2つの音声の長さ（45.16秒、33.8秒）は元の曲（94.12秒）よりもはるかに短く、少量の文脈を含む置換セクションであり、**完全な曲ではありません**。満足のいく候補を選んで手動で接続を続けることができます。デフォルトの`full_song`モードでは、2回の接続を完了し、2つの完全な曲を直接返します。 ### 完全な曲を直接返す 2つの候補を比較する必要がない場合は、ステップ1で`replace_section_result_mode`を`full_song`に設定します。インターフェースは自動的に最初の候補を選択して接続を完了し、1つの完全な曲を含む`data`配列を直接返します。この場合、`concat`を再度呼び出す必要はなく、費用には自動接続ステップが含まれます。 ### ステップ2：置換セクションを元の曲に接続する 上記で選択したセクション（例：`364f9d8b-ca25-463b-9a5e-d0b7139e2d6a`）に対して、[音楽接続](#音楽接続)の方法に従って`concat`タスクを開始します： ```json theme={null} { "action": "concat", "audio_id": "364f9d8b-ca25-463b-9a5e-d0b7139e2d6a", "model": "chirp-v5-5" } ``` 返されるのは接続された完全な曲で、以下のような例になります： ```json theme={null} { "success": true, "task_id": "5dbd4a78-0197-4ef3-9c16-8bddaf4f0c94", "trace_id": "580bd1da-2ad3-4d75-be1f-6c14bd4b489d", "data": [ { "id": "365a9640-0452-4567-80f0-4f5a2a17ddd5", "title": "新年快乐", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-012", "lyric": "[Intro]\n太鼓が鳴り響き 赤いランタンが高く掲げられる\n[Verse 1]\n爆竹の音が旧年を見送る\n春風が暖かく万家に入る\nお年玉の封筒が笑顔を引き出す\n金の蛇が舞い新春を祝う\n[Chorus]\n梅の花が咲き誇り春の気配が満ち溢れる\n梅の花が咲き誇り春の気配が満ち溢れる\n梅の花が咲き誇り春の気配が満ち溢れる\n梅の花が咲き誇り春の気配が満ち溢れる\n[Verse 2]\n餃子の香りが漂う年越しの夕食\nランタンが揺れ動き団円を照らす", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2026-05-06T06:56:46.057Z", "model": "chirp-v5-5", "state": "succeeded", "style": "伝統的な中国の新年、祝祭、女性ボーカル、アップビート", "duration": 105.28 } ] } ``` この時点で `duration` は完全な曲の長さ（105.28秒、元の曲の長さに相当）に回復し、`audio_url` が指し示すのは置き換えが完了した全曲です。これで「生成 → 置き換え部分 → 統合全曲」の二次創作プロセスが完了しました。 ## 声曲分離 曲を生成した後、伴奏と人声を個別に操作する二次創作が必要な場合、純音楽伴奏と清唱人声を分離できます。以下の内容を指定できます： * action：内容は `stems`。 * audio\_id：以前生成した曲のID。 例えば、元々生成された曲のIDが：ec13e502-d043-4eb2-92ee-e900c6da69d1の場合、パラメータを以下のように設定できます： ```json theme={null} { "action": "stems", "audio_id": "ec13e502-d043-4eb2-92ee-e900c6da69d1" } ``` 上記のパラメータを使用することで、声曲分離の結果を得ることができ、結果は以下の通りです： ```json theme={null} { "success": true, "task_id": "4050affc-f8a6-4cba-a86c-bf201eed053d", "trace_id": "5107ee58-687d-422f-9195-fa0e82e1fcc8", "data": [ { "id": "e3de0928-085a-42c4-b982-3b24738d1989", "title": "Deck the Sky - Vocals", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-013", "lyric": "[Verse]\nSnowflakes dance on rooftops high\nChildren's laughter fills the sky\nCarols ring from church bells loud\nHolidays a joyful crowd\n[Verse 2]\nCandy canes and cocoa warm\nWrapped up tight in our own storm\nStockings hung with dreams and cheer\nMagic growing every year\n[Chorus]\nDeck the sky with twinkling stars\nHoliday joy feels ours and ours\nSing the songs of love and light\nChristmas glows so pure and bright\n[Verse 3]\nFireside tales of long ago\nReindeer prance in icy glow\nEvergreen and tinsel’s gleam\nChristmas time a lovely dream\n[Bridge]\nHearts are full with friends and kin\nMistletoe for love to win\nGifts of love and hope we share\nChristmas spirit everywhere\n[Chorus]\nDeck the sky with twinkling stars\nHoliday joy feels ours and ours\nSing the songs of love and light\nChristmas glows so pure and bright", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "https://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.mp4?example=video-001", "created_at": "2025-01-05T07:49:16.881Z", "model": "", "state": "succeeded", "style": "holiday, jolly", "duration": 174.16 }, { "id": "ad5d7c89-709c-4eb4-a5a6-72f9f5e57fdb", "title": "Deck the Sky - Instrumental", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-014", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "https://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.mp4?example=video-002", "created_at": "2025-01-05T07:49:16.892Z", "model": "", "state": "succeeded", "style": "holiday, jolly", "duration": 174.16 } ] } ``` 生成された結果は上記のように、元々生成された曲の声曲分離のプロセスが完了しました。 ## 全軌道声曲分離 曲を生成した後、全軌道声曲分離操作を行う必要がある場合、以下の内容を指定できます： * action：内容は `all_stems`。 * audio\_id：以前生成した曲のID。 例えば、元々生成された曲のIDが：bdf23a5a-59f5-4103-b452-054a824a7f9fの場合、パラメータを以下のように設定できます： ```json theme={null} { "action": "all_stems", "audio_id": "bdf23a5a-59f5-4103-b452-054a824a7f9f" } ``` 上記のパラメータを使用することで、全軌道声曲分離の結果を得ることができ、結果は以下の通りです： ````json { theme={null} "success": true, "task_id": "f4b16fb9-8478-4857-88c7-b9a1f0bb9518", "trace_id": "9c560ebd-4fc6-4bdb-988a-8890160a92fb", "data": [ { "id": "f86ca64a-9519-4ea7-a592-52438e001412", "title": "安全之弦 (Vocals)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-015", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.770Z", "model": "chirp-ahi-stem-12-t1", "state": "succeeded", "duration": 154.92 }, { "id": "99e649a7-a394-47b9-a915-d7f847285a36", "title": "安全之弦 (Backing Vocals)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-016", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.770Z", "model": "chirp-ahi-stem-12-t1", "state": "succeeded", "duration": 154.92 }, { "id": "6d710bf7-809f-4fdc-bb63-b8cb3a456d42", "title": "安全之弦 (Drums)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-017", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.770Z", "model": "chirp-ahi-stem-12-t1", "state": "succeeded", "duration": 154.92 }, { "id": "e05f07e3-7d80-4713-8e51-7f176c733543", "title": "安全の弦 (ベース)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-018", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.770Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "93fe7cd8-62fd-4739-b78e-142c7e0b8562", "title": "安全の弦 (ギター)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-019", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.770Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "8367d71c-fdd3-441c-8ebe-70c33cca821b", "title": "安全の弦 (キーボード)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-020", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.770Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "28c03590-731c-416e-8fd3-95cdb3d75043", "title": "安全の弦 (パーカッション)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-021", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.770Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "3d4c1a28-4e1c-485a-8201-d21bb93aca2f", "title": "安全の弦 (ストリングス)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-022", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.770Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "b9db8ded-01ec-4e37-b8a5-64aab3a814c2", "title": "安全の弦 (シンセ)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-023", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.770Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "10a5248e-32e6-42b9-8da1-678a8a392aef", "title": "安全の弦 (FX)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-024", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.770Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "2d272128-111f-4901-8f62-5ae1eb43095a", "title": "安全の弦 (ブラス)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-025", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.770Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "4a7c19a5-f8d4-4e4a-add9-aa0bad9307cc", "title": "安全の弦 (ウッドウィンズ)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-026", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.770Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "1ca774f9-3e75-48a6-941b-808875eadcd2", "title": "安全の弦 (ボーカル)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-027", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.770Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "14c5ffc7-addf-4fee-afd2-4b8b3e7ee470", "title": "安全の弦 (バックボーカル)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-028", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.771Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "9d044557-450d-48ab-90dc-8eaf6f1cdb6c", "title": "安全の弦 (ドラム)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-029", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.771Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "efd052d0-c12f-47b3-8282-1f3ef7610e1f", "title": "安全の弦 (ベース)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-030", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.771Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "5775372b-292e-4420-96ef-60e57a60cc1f", "title": "安全の弦 (ギター)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-031", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.771Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "dab3f220-19cd-408e-9b96-30ec18f5b049", "title": "安全の弦 (キーボード)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-032", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.771Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "2d0cd6d4-af82-4bb5-86fe-d92bdb367157", "title": "安全の弦 (パーカッション)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-033", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.771Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "f3191a1a-5e8d-4afe-b638-3add222d52cd", "title": "安全の弦 (ストリングス)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-034", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.771Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "a8834ea5-200b-4206-a812-9780ef336660", "title": "安全の弦 (シンセ)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-035", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.771Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "f50d1a31-ef72-400a-b8ae-0367849d007d", "title": "安全の弦 (FX)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-036", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.771Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, { "id": "cb581673-23cc-40d6-9f9b-0f76720f0d18", "title": "安全の弦 (ブラス)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-037", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.771Z", "model": "chirp-ahi-stem-12-t1", "state": "成功", "duration": 154.92 }, ```json { "id": "d91cfb52-f0a3-4546-bf8a-2ad14c3775a5", "title": "安全之弦 (Woodwinds)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-038", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-06-11T02:40:30.771Z", "model": "chirp-ahi-stem-12-t1", "state": "succeeded", "duration": 154.92 } ] } ```` 生成された結果は上記のように、元の生成された曲の声曲分離プロセスが完了しました。 ## カスタム生成の高度なパラメータ 公式はカスタムモードで高度なパラメータ `weirdness`==>`Weirdness`、`style_influence`==>`Style Influence`、`audio_weight`==>`Audio Influence`を使用して生成することを許可しています。対応する公式の例は以下の通りです：

高度なパラメータの範囲はすべて0-1の間で、具体的なパラメータは以下の図の通りです：

記入が完了した後、自動生成されたコードは以下の通りです：

対応するPythonコード： ```python theme={null} import requests url = "https://api.acedata.cloud/suno/audios" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "action": "generate", "model": "chirp-v4-5", "lyric": "Hello Hello Hello ", "custom": True, "weirdness": 0.4, "style_influence": 0.4, "audio_weight": 0.4 } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` 実行をクリックすると、以下のような結果が得られます： ```json theme={null} { "success": true, "task_id": "2f3aa682-e1a7-43a9-9fbb-ed0ce8668a4b", "trace_id": "07408194-7deb-4a52-a36d-9a9a13143b5f", "data": [ { "id": "c66e2077-7580-43f2-9937-c67a8afcd8bd", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-039", "lyric": "Hello Hello Hello ", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-07-10T12:54:35.199Z", "model": "chirp-auk", "state": "succeeded", "style": "", "duration": 187.92 }, { "id": "a922f97b-307c-4c4d-aae3-a47ba8202a10", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-040", "lyric": "Hello Hello Hello ", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-07-10T12:54:35.199Z", "model": "chirp-auk", "state": "succeeded", "style": "", "duration": 229.64 } ] } ``` これにより、高度なパラメータを使用してカスタム曲を生成し、結果は上記のように似ています。 ## 曲の長さを制御する デフォルトでは生成される曲の長さはモデルが自動的に決定し、通常は30秒から4分の間です。より長いまたは短い作品が必要な場合は、`duration`パラメータを使用して希望の長さを指定できます。単位は秒で、値は10から360の間の整数です。 このパラメータはカスタムモード（`custom`が`true`）の曲生成に使用されます。特に注意すべきは、`duration`は**傾向的なヒントであり、厳密な制約ではない**ことです：モデルはこの値を参考にして創作しますが、達成を保証するものではありません。実際の長さは通常、期待値よりも明らかに短くなることが多く、同じリクエストから返される2曲の長さも数倍異なる可能性があります。完全に同じリクエストでも、複数回提出した場合の長さは大きく異なることがあります。したがって、正確な長さの制御として使用しないでください。ビジネス上、固定の長さが必要な場合は、完成品を受け取った後に自分でカットするか、再試行してください。 対応するPythonコード： ```python theme={null} import requests url = "https://api.acedata.cloud/suno/audios" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "action": "generate", "model": "chirp-v5-5", "custom": True, "title": "Under the City Lights", "style": "lo-fi piano", "lyric": "[Verse]\nSunrise creepin\nGold on the floor\n[Chorus]\nUnder the city lights\n", "duration": 330 } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` 注意すべきは、リクエスト内の`duration`は**希望の長さ**であり、レスポンス`data`内の各曲の`duration`フィールドはその曲の**実際の長さ**です。両者の名称は同じですが、意味は異なり、実際の長さが希望値に等しいことは保証されません。歌詞の長さは完成品の長さに影響を与える主要な要因の一つであり、より長い作品が必要な場合は、より完全な歌詞を同時に提供することをお勧めします。 インターフェースは`duration`に対して追加の検証を行わず、パラメータはそのままモデルに渡されます。現在のモードまたはモデルがサポートしていない値が渡された場合、その値が無視される可能性があります。効果を確認するために、最初に1回リクエストを行ってからバッチ使用することをお勧めします。 ## Add Insterumental 機能 2025年8月にsunoはAdd Insterumental機能を新たに発表しました。まず、無伴奏の清唱曲をアップロードして、sunoに音楽をつけてもらう必要があります。まず、[Suno Upload API](https://platform.acedata.cloud/documents/suno-upload)にアクセスして、無伴奏の清唱曲をアップロードします。対応する操作は以下の図の通りです：

次に、アップロード後の`audio_id`を記録する必要があります。具体的な結果は以下の図の通りです：

最後に、`audio_id`：92254cab-3372-4d9e-bce9-cdcfdbc39070を取得し、次のパラメータを記入する必要があります： * action：内容为 `underpainting`。 * underpainting\_start：対上传された曲に伴奏を追加する開始時間、デフォルト値は 0。 * underpainting\_end：対上传された曲に伴奏を追加する終了時間、曲の総時間より小さくなければならない。 * audio\_id：アップロードされたアカペラの曲の ID。 * style：伴奏のスタイル、歌詞は不要な方が良い、結局は声の伴奏だから。 記入が完了した後、自動生成されたコードは以下の通りです：

対応する Python コード： ```python theme={null} import requests url = "https://api.acedata.cloud/suno/audios" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "action": "underpainting", "model": "chirp-v4-5", "style": "ポップラップ、 uplifting、魅力的な男性ボーカル、ピアノ、シンセ、エレキギター、ドライビングベース、明確な構造", "audio_id": "92254cab-3372-4d9e-bce9-cdcfdbc39070", "underpainting_end": 120 } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` クリックして実行すると、以下のような結果が得られます： ```json theme={null} { "success": true, "task_id": "822d2e14-c535-4d48-a4e5-1b6ab00b04a7", "trace_id": "257eac2c-8e4f-44d0-8454-5e215111eefa", "data": [ { "id": "2788cd21-bd84-422d-beb5-859c60fbf5b6", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-041", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-08-27T15:25:42.548Z", "model": "chirp-v4", "state": "succeeded", "style": "ポップラップ、 uplifting、魅力的な男性ボーカル、ピアノ、シンセ、エレキギター、ドライビングベース、明確な構造", "duration": 10.16 }, { "id": "a4bb7220-e971-4cbf-a626-b86c648bcf55", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-042", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-08-27T15:25:42.548Z", "model": "chirp-v4", "state": "succeeded", "style": "ポップラップ、 uplifting、魅力的な男性ボーカル、ピアノ、シンセ、エレキギター、ドライビングベース、明確な構造", "duration": 2.52 } ] } ``` これで、アップロードされたアカペラの曲に伴奏を追加する操作が完了しました。結果は上記のようになります。 ## Add Vocals 機能 2025年8月にsunoが新たに追加したAdd Vocals機能では、まず純粋な音楽をアップロードし、sunoに歌詞を作成させ、人声で歌わせる必要があります。まず、[Suno Upload API](https://platform.acedata.cloud/documents/suno-upload)にアクセスして、アカペラの無伴奏曲をアップロードします。対応する操作は以下の図の通りです：

次に、アップロード後の`audio_id`を記録する必要があります。具体的な結果は以下の図の通りです：

最終的に得られた`audio_id`は：92254cab-3372-4d9e-bce9-cdcfdbc39070です。次に、以下のパラメータを記入する必要があります： * action：内容は `overpainting`。 * overpainting\_start：アップロードされた曲に人声を追加する開始時間、デフォルト値は 0。 * overpainting\_end：アップロードされた曲に人声を追加する終了時間、曲の総時間より小さくなければならない。 * audio\_id：アップロードされたアカペラの曲の ID。 * custom：このモードでは必ずカスタムモードで歌詞を入力する必要があります。 * lyric：カスタムモードで入力した歌詞。 * style：伴奏のスタイル。 記入が完了した後、自動生成されたコードは以下の通りです：

対応する Python コード： ```python theme={null} import requests url = "https://api.acedata.cloud/suno/audios" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "action": "overpainting", "model": "chirp-v4-5", "lyric": "Yea your were the best I could get \\nBut I knew that it couldn’t last \\nStayed down since we were friends \\nHad to leave those thoughts in the past \\nMade like 40k just last week \\nOn top of the 20 with my babe\\ndon’t care for what niggas say", "custom": True, "audio_id": "92254cab-3372-4d9e-bce9-cdcfdbc39070", "overpainting_end": 120 } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` クリックして実行すると、以下のような結果が得られます： ```json theme={null} { "success": true, "task_id": "31bb250e-6614-49ec-ac85-631f224daeba", "trace_id": "efe8e7f3-9a65-4f13-a9f8-51e8478899df", "data": [ { "id": "a597f945-64df-4722-a631-d436450832bd", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-043", "lyric": "そう、君は私が得られる中で最高だった \\nでもそれが続かないことは分かっていた \\n友達だった頃からずっと落ち込んでいた \\nその考えを過去に置かなければならなかった \\n先週だけで約40k稼いだ \\n私のベイビーと一緒に20を加えて\\n他の人が何を言おうと気にしない", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-08-27T15:33:51.550Z", "model": "chirp-v4", "state": "succeeded", "style": "", "duration": 105.32 }, { "id": "b41a8b91-3d88-4ebd-a6cf-732764b24954", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-044", "lyric": "そう、君は私が得られる中で最高だった \\nでもそれが続かないことは分かっていた \\n友達だった頃からずっと落ち込んでいた \\nその考えを過去に置かなければならなかった \\n先週だけで約40k稼いだ \\n私のベイビーと一緒に20を加えて\\n他の人が何を言おうと気にしない", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-08-27T15:33:51.550Z", "model": "chirp-v4", "state": "succeeded", "style": "", "duration": 148.16 } ] } ``` こうして、アップロードされたアカペラの無音楽曲に対して人声を追加する操作が完了しました。結果は上記のように似ています。 ## Remaster 機能 2025年12月にsunoが新たにリリースしたRemaster機能は、曲を再生成することができ、アカウントを跨いではいけません。また、以下のパラメータを記入する必要があります： * action：内容は `remaster`。 * audio\_id：再生成する曲のID。 * model：v4.5+、v5のみサポート。 * variation\_category：v5以上のバージョンでのみサポートされ、3つの値 high normal subtle のみ。 記入が完了した後、自動的に以下のコードが生成されました：

対応するPythonコード： ```python theme={null} import requests url = "https://api.acedata.cloud/suno/audios" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "action": "remaster", "variation_category": "high", "audio_id": "21fd46d4-45c3-4826-bec9-3f3df667902e" } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` 実行をクリックすると、以下のような結果が得られることがわかります： ```json theme={null} { "success": true, "task_id": "791ee74c-9363-4352-afe7-babb19b89899", "trace_id": "77acda57-c3d4-4e11-a506-4f50e0609916", "data": [ { "id": "b0515cdf-9cb5-46cd-b0fe-10a239dc9274", "title": "Navidad en costura (Remastered)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-045", "image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-046", "lyric": "エテロでは授業が続いている、\\nクリスマスでも休みはない；\\nグループはクリスマスキャロルの中で縫い、\\n良い一切れのトゥロンを。\\n人気のある場所が扉を開き、\\n工房はより良い音を出す；\\n糸、針、そして楽しい歌で\\n私たちはより良い時間を過ごす。\\n私たちは縫い続け、\\n音楽と楽しみで；\\n生徒たちは\\nたくさんのお菓子を食べる。", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-12-04T13:09:59.936Z", "model": "chirp-v4", "state": "succeeded", "style": "Villancico", "duration": 32.2 }, { "id": "06edab94-a4f9-4c0c-abac-a2e8a97c76a8", "title": "Navidad en costura (Remastered)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-047", "image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-048", "lyric": "エテロでは授業が続いている、\\nクリスマスでも休みはない；\\nグループはクリスマスキャロルの中で縫い、\\n良い一切れのトゥロンを。\\n人気のある場所が扉を開き、\\n工房はより良い音を出す；\\n糸、針、そして楽しい歌で\\n私たちはより良い時間を過ごす。\\n私たちは縫い続け、\\n音楽と楽しみで；\\n生徒たちは\\nたくさんのお菓子を食べる。", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2025-12-04T13:09:59.936Z", "model": "chirp-v4", "state": "succeeded", "style": "Villancico", "duration": 32.2 } ] } ``` こうして、生成された曲の再生成操作が完了しました。結果は上記のように似ています。 ## Mashup 混曲生成功能 2025年12月にsunoが新たにリリースしたMashup機能は、2曲の参考曲に基づいて曲を生成することができ、以下のパラメータを記入する必要があります： * action：内容は `mashup`。 * mashup\_audio\_ids：2曲の参考曲のID。 記入が完了した後、自動的に以下のコードが生成されました：

対応するPythonコード： ```python theme={null} ``` ```python theme={null} import requests url = "https://api.acedata.cloud/suno/audios" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "action": "mashup", "lyric": "サンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\n\\nサンブイ、来て \\nサンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\n\\nサンブイ、来て \\nサンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\n\\nサンブイ、来て \\nサンブイ、戻ってきて \\nサンブイ、サンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\n\\nサンブイ、来て \\nサンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\nサンブイ、戻ってきて", "model": "chirp-v4-5", "custom": True, "instrumental": False, "mashup_audio_ids": ["9f102969-0024-479e-b38f-c0c5db21383d","6aebb715-701c-433f-b976-a7ff5cf16255"] } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` クリックして実行すると、以下のような結果が得られます： ```json theme={null} { "success": true, "task_id": "3fe070eb-2ab1-4424-909c-acfe3ca761af", "trace_id": "2b220382-7a84-4853-ae43-05cdcad233a9", "data": [ { "id": "5ff751dc-0e72-4de9-a54b-2cad50984b47", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-049", "image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-050", "lyric": "サンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\n\\nサンブイ、来て \\nサンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\n\\nサンブイ、来て \\nサンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\n\\nサンブイ、来て \\nサンブイ、戻ってきて \\nサンブイ、サンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\n\\nサンブイ、来て \\nサンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\nサンブイ、戻ってきて", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2026-01-25T15:13:30.181Z", "model": "chirp-v4-5", "state": "succeeded", "style": "", "duration": 219.08 }, { "id": "19c515c4-d7b3-4a17-8ab0-dd1ebd4861b8", "title": "", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-051", "image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-052", "lyric": "サンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\n\\nサンブイ、来て \\nサンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\n\\nサンブイ、来て \\nサンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\n\\nサンブイ、来て \\nサンブイ、戻ってきて \\nサンブイ、サンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\n\\nサンブイ、来て \\nサンブイ、戻ってきて \\nブルースポーン、グリーンスポーンがあなたをスポーンにしている \\nサンブイ、戻ってきて", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2026-01-25T15:13:30.181Z", "model": "chirp-v4-5", "state": "succeeded", "style": "", "duration": 163.12 } ] } ``` これで参考曲の混曲生成操作が完了し、結果は上記のようになります。 ## サンプル 取样生成歌曲 2025年12月にsunoが新たにサンプル機能を発表しました。この機能は、2曲の参考曲に基づいて曲を生成することができ、次のパラメータを入力する必要があります： * action：内容は `samples`。 * samples\_start：サンプリング開始時間。 * samples\_end：サンプリング終了時間。 * audio\_id：サンプリングする参考曲のID。 入力が完了すると、自動的に以下のコードが生成されます：

対応するPythonコード： ```python theme={null} import requests url = "https://api.acedata.cloud/suno/audios" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "action": "samples", "model": "chirp-v5", "lyric": "[Verse 1]\\n電話が点灯\\n手にヘッドライン\\n作り話のよう\\nまだ「あなたは理解できない」と言う\\nあなたの名前\\n私の名前\\nスクロールの横に並んで\\n冷たい黒いテキスト\\n私がかつて持っていたストーリーの上に\\n\\n[Chorus]\\nあなたは速報\\n私はただ壊れている\\n一面の真実\\n心はまだ震えている\\nみんなが読む\\n私たちがすでに知っていたこと\\nあなたは今やストーリー\\nそして私はあなたがそれを壊した人\\n\\n[Verse 2]\\n隣人が話す\\n半開きのドア越しに\\nコーヒーが冷める\\nひびの入った古い床の上で\\nあなたのスーツケースがパチンと閉まる\\nカメラのフラッシュのように\\n最後の引用\\nそれからあなたは黒に切り替える\\n\\n[Chorus]\\nあなたは速報\\n私はただ壊れている\\n一面の真実\\n心はまだ震えている\\nみんなが読む\\n私たちがすでに知っていたこと\\nあなたは今やストーリー\\nそして私はあなたがそれを壊した人\\n\\n[Bridge]\\n戻るラインはあるのか\\nそれとも私たちを置き去りにするフィードだけか\\n教えて\\n誰が\\n最後のビューを得るのか\\n私があなたとトレンドを止めるとき\\n\\n[Chorus]\\nあなたは速報\\n私はただ壊れている\\n一面の真実\\n心はまだ震えている\\nみんなが読む\\n私たちがすでに知っていたこと\\nあなたは今やストーリー\\nそして私はあなたがそれを壊した人（うん）", "custom": True, "instrumental": False, "audio_id": "0fa07665-6b8e-4a8b-8bd3-7e0cfcdada88", "samples_end": 102.16, "samples_start": 59.88 } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` クリックして実行すると、以下のような結果が得られます： ```json theme={null} { "success": true, "task_id": "12135a45-6384-4683-9bb1-64f19933915a", "trace_id": "683e559d-340e-4c72-8fae-e683442ac7e9", "data": [ { "id": "9a0b680f-a9ea-4a36-8695-8ea777ab6ee7", "title": "風の中の口笛", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-053", "image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-054", "lyric": "[Verse 1]\n電話が光る\n手に持った見出し\n作り物のように感じる\nそれでも「あなたは理解できない」と言う\nあなたの名前\n私の名前\nスクロールの横に並んで\n冷たい黒いテキスト\n私がかつて持っていた物語の上に\n[Chorus]\nあなたは速報\n私はただ壊れている\n一面の真実\n心はまだ震えている\nみんなが読む\n私たちがすでに知っていたこと\nあなたは今や物語\n私はあなたがそれを壊した相手\n[Verse 2]\n隣人が話す\n半分閉じたドア越しに\nコーヒーが冷める\nひび割れた古い床の上で\nあなたのスーツケースがパチンと音を立てる\nカメラのフラッシュのように\n最後の引用\nそしてあなたは黒に切り替える\n[Chorus]\nあなたは速報\n私はただ壊れている\n一面の真実\n心はまだ震えている\nみんなが読む\n私たちがすでに知っていたこと\nあなたは今や物語\n私はあなたがそれを壊した相手\n[Bridge]\n戻るための線はあるのか\nそれとも私たちを置き去りにするフィードだけか\n教えて\n誰が\n最後の視点を得るのか\n私があなたとトレンドを止めたとき\n[Chorus]\nあなたは速報\n私はただ壊れている\n一面の真実\n心はまだ震えている\nみんなが読む\n私たちがすでに知っていたこと\nあなたは今や物語\n私はあなたがそれを壊した相手（はい）", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2026-01-31T14:34:45.043Z", "model": "chirp-v5", "state": "succeeded", "style": "アコースティックに少しの楽観主義を加えた、フォークポップ、女性ボーカル", "duration": 176.92 }, { "id": "66473dee-3aaf-43b2-80fd-76568b3abbb1", "title": "風の中の口笛", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-055", "image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-056", "lyric": "[Verse 1]\n電話が光る\n手に持った見出し\n作り物のように感じる\nそれでも「あなたは理解できない」と言う\nあなたの名前\n私の名前\nスクロールの横に並んで\n冷たい黒いテキスト\n私がかつて持っていた物語の上に\n[Chorus]\nあなたは速報\n私はただ壊れている\n一面の真実\n心はまだ震えている\nみんなが読む\n私たちがすでに知っていたこと\nあなたは今や物語\n私はあなたがそれを壊した相手\n[Verse 2]\n隣人が話す\n半分閉じたドア越しに\nコーヒーが冷める\nひび割れた古い床の上で\nあなたのスーツケースがパチンと音を立てる\nカメラのフラッシュのように\n最後の引用\nそしてあなたは黒に切り替える\n[Chorus]\nあなたは速報\n私はただ壊れている\n一面の真実\n心はまだ震えている\nみんなが読む\n私たちがすでに知っていたこと\nあなたは今や物語\n私はあなたがそれを壊した相手\n[Bridge]\n戻るための線はあるのか\nそれとも私たちを置き去りにするフィードだけか\n教えて\n誰が\n最後の視点を得るのか\n私があなたとトレンドを止めたとき\n[Chorus]\nあなたは速報\n私はただ壊れている\n一面の真実\n心はまだ震えている\nみんなが読む\n私たちがすでに知っていたこと\nあなたは今や物語\n私はあなたがそれを壊した相手（はい）", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2026-01-31T14:34:45.043Z", "model": "chirp-v5", "state": "succeeded", "style": "アコースティックに少しの楽観主義を加えた、フォークポップ、女性ボーカル", "duration": 177.48 } ] } ``` こうして、サンプリング生成曲の操作が完了し、結果は上記のようになります。 ## Inspo インスピレーション創作機能 Suno の新しい Inspo インスピレーション創作機能は、1 から 4 段の参考音声をインスピレーションの源として、新しい音楽を生成します。カバーとは異なり、Inspo は原曲を再現するのではなく、参考音声からスタイルのインスピレーションを抽出し、プロンプトやスタイルタグなどと組み合わせて新しい作品を生成します。使用時には以下のパラメータを記入する必要があります： * action：内容は `inspo`。 * audio\_urls：参考音声の URL リスト、1 から 4 の公開アクセス可能な音声アドレスを提供する必要があります。 * model：使用するモデル、例えば `chirp-v5`。 * prompt：歌詞や創作のヒント（オプション）。 * tags：音楽スタイルタグ、例えば `acoustic, folk, warm`（オプション）。 * title：曲のタイトル（オプション）。 * audio\_weight：生成結果に対する参考音声の影響の重み、範囲は 0 から 1（オプション）。 > 説明：参考音声は公開アクセス可能な音声ファイルでなければなりません。参考音声がプラットフォームの曲ライブラリにある既知の録音と完全に一致する場合、Suno は著作権の確認により生成を拒否する可能性があるため、自分の音声や Suno が生成した音声をインスピレーションの源として使用することをお勧めします。 対応する Python コード： ```python theme={null} import requests url = "https://api.acedata.cloud/suno/audios" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "action": "inspo", "model": "chirp-v5", "audio_urls": [ "https://cdn1.suno.ai/935dd2f5-ddef-43cf-8e68-5a262425694d.mp3" ], "prompt": "温かいアコースティックフォークと柔らかいボーカル", "tags": "アコースティック, フォーク, 温かい", "title": "Inspo デモ", "audio_weight": 0.6 } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` クリックして実行すると、次のような結果が得られます： ```json theme={null} { "success": true, "task_id": "725e6b41-78d0-4adf-856c-05e81098c029", "trace_id": "8c2f0b3e-2f6a-4738-8b1d-c58068ca3dab", "data": [ { "id": "20ca5628-86e0-4c32-8ae4-9f0c481e45f3", "title": "インスピレーションデモ", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-057", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2026-06-18T13:01:53.910Z", "model": "chirp-v5", "state": "成功", "style": "アコースティック, フォーク, 温かい", "duration": 36.92 }, { "id": "8744a796-9961-45af-868d-4f3bc1c44257", "title": "インスピレーションデモ", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-058", "lyric": "", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "", "created_at": "2026-06-18T13:01:53.910Z", "model": "chirp-v5", "state": "成功", "style": "アコースティック, フォーク, 温かい", "duration": 84.16 } ] } ``` こうしてインスピレーション創作の操作が完了し、返された結果は通常の生成された曲と一致します。 ## 非同期コールバック Sunoが音楽を生成するのにかかる時間は比較的長く、約1〜2分かかります。APIが長時間応答しない場合、HTTPリクエストは接続を維持し続け、追加のシステムリソースを消費するため、このAPIは非同期コールバックのサポートも提供しています。 全体の流れは、クライアントがリクエストを発行する際に、追加で`callback_url`フィールドを指定し、クライアントがAPIリクエストを発行した後、APIはすぐに結果を返し、現在のタスクIDを示す`task_id`フィールド情報を含みます。タスクが完了すると、生成された音楽の結果がPOST JSON形式でクライアントが指定した`callback_url`に送信され、その中にも`task_id`フィールドが含まれているため、タスクの結果をIDで関連付けることができます。 以下の例を通じて、具体的にどのように操作するかを理解しましょう。 まず、WebhookコールバックはHTTPリクエストを受信できるサービスであり、開発者は自分が構築したHTTPサーバーのURLに置き換える必要があります。ここではデモのために、公開のWebhookサンプルサイト[https://webhook.site/を使用します。このサイトを開くとWebhook](https://webhook.site/を使用します。このサイトを開くとWebhook) URLが得られます。 ![](https://cdn.acedata.cloud/fwfqin.png) このURLをコピーすればWebhookとして使用できます。このサンプルは[https://webhook.site/03e60575-3d96-4132-b681-b713d78116e2です。](https://webhook.site/03e60575-3d96-4132-b681-b713d78116e2です。) 次に、`callback_url`フィールドを上記のWebhook URLに設定し、`prompt`を入力します。 ![](https://cdn.acedata.cloud/x8xql1.png) 実行ボタンをクリックすると、すぐに結果が得られます。 ``` { "task_id": "44472ab8-783b-4054-b861-5bf14e462f60" } ``` 少し待つと、[https://webhook.site/03e60575-3d96-4132-b681-b713d78116e2で生成された曲の結果を観察できます。](https://webhook.site/03e60575-3d96-4132-b681-b713d78116e2で生成された曲の結果を観察できます。) ![](https://cdn.acedata.cloud/f9kosb.png) 内容は以下の通りです。 ```json theme={null} { "success": true, "task_id": "44472ab8-783b-4054-b861-5bf14e462f60", "data": [ { "id": "da4324e5-84b2-484b-b0e9-dd261381c594", "title": "冬のささやき", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-059", "lyric": "[Verse]\n雪が静かに空から降り\n子供たちが通り過ぎるときに笑って\n火がパチパチと音を立て\n居心地よく温かい\nクリスマスの精神が広がり始める\n[Verse 2]\nきらめく光\n見るべき光景\nストッキングが吊るされ\n金で満たされるのを待っている\n愛で包まれた贈り物\n高く積まれ\n空気中の興奮\n否定できない\n[Chorus]\n冬が風の中でささやく\n喜びと愛をもたらす\nこの季節を祝おう\n私たちが会えない人たちと共に", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "https://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.mp4?example=video-003", "created_at": "2024-05-11T07:33:05.430Z", "model": "chirp-v3", "prompt": "クリスマスのための歌", "style": "ポップ" }, { "id": "b878a87b-a0db-4046-8ccd-ecd2fb3d4372", "title": "冬のささやき", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-060", "lyric": "[Verse]\n雪が静かに空から降り\n子供たちが通り過ぎるときに笑って\n火がパチパチと音を立て\n居心地よく温かい\nクリスマスの精神が広がり始める\n[Verse 2]\nきらめく光\n見るべき光景\nストッキングが吊るされ\n金で満たされるのを待っている\n愛で包まれた贈り物\n高く積まれ\n空気中の興奮\n否定できない\n[Chorus]\n冬が風の中でささやく\n喜びと愛をもたらす\nこの季節を祝おう\n私たちが会えない人たちと共に", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": "https://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.mp4?example=video-004", "created_at": "2024-05-11T07:33:05.430Z", "model": "chirp-v3", "prompt": "クリスマスのための歌", "style": "ポップ" } ] } ``` 結果には`task_id`フィールドがあり、他のフィールドは前述の内容と似ています。このフィールドを通じてタスクの関連付けが可能です。 もちろん、ストリーミング呼び出しを通じて結果を取得することもできます。リクエストヘッダー内の`accept`の値を`application/x-ndjson`に設定するだけで済みます。以下に示すのは、入力の例です。

待機中に、以下の出力を得ることができます。 ```json theme={null} {"success":true,"task_id":"1af4b454-ce84-4512-a0a2-de3f8574ecd8","data":[{"id":"1f610752-f426-4fd5-89a8-ba2ad0370881","title":"雪の結晶とミスルトー","lyric":"[Verse]\n木にまたライトが絡まっている\n猫がリースを倒した\nオーブンでクッキーが焼けすぎている\nでも私は歯を見せて笑っている\n[Prechorus]\n雪が空にグリッターのように降っている\n今年は飛ぶような気がする\n[Chorus]\n雪の結晶とミスルトー\n私が行くところどこにでも\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー\n[Verse 2]\nおばあちゃんが少し音程を外して歌っている\n子供たちが大声で笑っている\n犬が七面鳥の足を盗んだ\n混沌はクリスマスの群衆\n[Prechorus]\nでも火がパチパチと音を立てて\n暖かく明るい\nそして今夜私の心はキャンドルだ\n[Chorus]\n雪の結晶とミスルトー\n私が行くところどこにでも\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー","audio_url":"","video_url":"","created_at":"2025-12-13T11:29:25.101Z","model":"chirp-v5","state":"pending","prompt":"クリスマスのための歌","style":"高揚感のある、オーケストラとベル、アコースティックギター"},{"id":"d1a3109d-799b-401e-b032-4b501bcf26f3","title":"雪の結晶とミスルトー","lyric":"[Verse]\n木にまたライトが絡まっている\n猫がリースを倒した\nオーブンでクッキーが焼けすぎている\nでも私は歯を見せて笑っている\n[Prechorus]\n雪が空にグリッターのように降っている\n今年は飛ぶような気がする\n[Chorus]\n雪の結晶とミスルトー\n私が行くところどこにでも\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー\n[Verse 2]\nおばあちゃんが少し音程を外して歌っている\n子供たちが大声で笑っている\n犬が七面鳥の足を盗んだ\n混沌はクリスマスの群衆\n[Prechorus]\nでも火がパチパチと音を立てて\n暖かく明るい\nそして今夜私の心はキャンドルだ\n[Chorus]\n雪の結晶とミスルトー\n私が行くところどこにでも\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー","audio_url":"","video_url":"","created_at":"2025-12-13T11:29:25.101Z","model":"chirp-v5","state":"pending","prompt":"クリスマスのための歌","style":"高揚感のある、オーケストラとベル、アコースティックギター"}]} {"success":true,"task_id":"1af4b454-ce84-4512-a0a2-de3f8574ecd8","data":[{"id":"1f610752-f426-4fd5-89a8-ba2ad0370881","title":"雪の結晶とミスルトー","image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-061","image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-062","lyric":"[Verse]\n木にまたライトが絡まっている\n猫がリースを倒した\nオーブンでクッキーが焼けすぎている\nでも私は歯を見せて笑っている\n[Prechorus]\n雪が空にグリッターのように降っている\n今年は飛ぶような気がする\n[Chorus]\n雪の結晶とミスルトー\n私が行くところどこにでも\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー\n[Verse 2]\nおばあちゃんが少し音程を外して歌っている\n子供たちが大声で笑っている\n犬が七面鳥の足を盗んだ\n混沌はクリスマスの群衆\n[Prechorus]\nでも火がパチパチと音を立てて\n暖かく明るい\nそして今夜私の心はキャンドルだ\n[Chorus]\n雪の結晶とミスルトー\n私が行くところどこにでも\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー","audio_url":"https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3","video_url":"","created_at":"2025-12-13T11:29:25.101Z","model":"chirp-v5","state":"running","prompt":"クリスマスのための歌","style":"高揚感のある、オーケストラとベル、アコースティックギター"},{"id":"d1a3109d-799b-401e-b032-4b501bcf26f3","title":"雪の結晶とミスルトー","image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-063","image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-064","lyric":"[Verse]\n木にまたライトが絡まっている\n猫がリースを倒した\nオーブンでクッキーが焼けすぎている\nでも私は歯を見せて笑っている\n[Prechorus]\n雪が空にグリッターのように降っている\n今年は飛ぶような気がする\n[Chorus]\n雪の結晶とミスルトー\n私が行くところどこにでも\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー\n[Verse 2]\nおばあちゃんが少し音程を外して歌っている\n子供たちが大声で笑っている\n犬が七面鳥の足を盗んだ\n混沌はクリスマスの群衆\n[Prechorus]\nでも火がパチパチと音を立てて\n暖かく明るい\nそして今夜私の心はキャンドルだ\n[Chorus]\n雪の結晶とミスルトー\n私が行くところどこにでも\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー","audio_url":"https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3","video_url":"","created_at":"2025-12-13T11:29:25.101Z","model":"chirp-v5","state":"running","prompt":"クリスマスのための歌","style":"高揚感のある、オーケストラとベル、アコースティックギター"}]} {"success":true,"task_id":"1af4b454-ce84-4512-a0a2-de3f8574ecd8","data":[{"id":"1f610752-f426-4fd5-89a8-ba2ad0370881","title":"雪の結晶とミスルトー","image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-065","image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-066","lyric":"[Verse]\nツリーにライトが再び絡まっている\n猫がリースを倒した\nオーブンでクッキーが焼けている\nでも私はまだ歯を見せて笑っている\n[Prechorus]\n雪が空にグリッターのように降っている\n今年は飛ぶような気がする\n[Chorus]\n雪の結晶とミスルトー\n私が行くところすべてに\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー\n[Verse 2]\nおばあちゃんが少し音程を外して歌っている\n子供たちが大声で笑っている\n犬が七面鳥の足を盗んだ\n混沌はクリスマスの群衆\n[Prechorus]\nでも火がパチパチと音を立てている\n暖かくて明るい\nそして今夜私の心はキャンドルのようだ\n[Chorus]\n雪の結晶とミスルトー\n私が行くところすべてに\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー","audio_url":"https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3","video_url":"","created_at":"2025-12-13T11:29:25.101Z","model":"chirp-v5","state":"succeeded","prompt":"クリスマスのための歌","style":"高揚感のある、オーケストラとベル、アコースティックギター","duration":129.92},{"id":"d1a3109d-799b-401e-b032-4b501bcf26f3","title":"雪の結晶とミスルトー","image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-067","image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-068","lyric":"[Verse]\nツリーにライトが再び絡まっている\n猫がリースを倒した\nオーブンでクッキーが焼けている\nでも私はまだ歯を見せて笑っている\n[Prechorus]\n雪が空にグリッターのように降っている\n今年は飛ぶような気がする\n[Chorus]\n雪の結晶とミスルトー\n私が行くところすべてに\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー\n[Verse 2]\nおばあちゃんが少し音程を外して歌っている\n子供たちが大声で笑っている\n犬が七面鳥の足を盗んだ\n混沌はクリスマスの群衆\n[Prechorus]\nでも火がパチパチと音を立てている\n暖かくて明るい\nそして今夜私の心はキャンドルのようだ\n[Chorus]\n雪の結晶とミスルトー\n私が行くところすべてに\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー","audio_url":"https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3","video_url":"","created_at":"2025-12-13T11:29:25.101Z","model":"chirp-v5","state":"running","prompt":"クリスマスのための歌","style":"高揚感のある、オーケストラとベル、アコースティックギター"}]} {"success":true,"task_id":"1af4b454-ce84-4512-a0a2-de3f8574ecd8","data":[{"id":"1f610752-f426-4fd5-89a8-ba2ad0370881","title":"雪の結晶とミスルトー","image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-069","image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-070","lyric":"[Verse]\nツリーにライトが再び絡まっている\n猫がリースを倒した\nオーブンでクッキーが焼けている\nでも私はまだ歯を見せて笑っている\n[Prechorus]\n雪が空にグリッターのように降っている\n今年は飛ぶような気がする\n[Chorus]\n雪の結晶とミスルトー\n私が行くところすべてに\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー\n[Verse 2]\nおばあちゃんが少し音程を外して歌っている\n子供たちが大声で笑っている\n犬が七面鳥の足を盗んだ\n混沌はクリスマスの群衆\n[Prechorus]\nでも火がパチパチと音を立てている\n暖かくて明るい\nそして今夜私の心はキャンドルのようだ\n[Chorus]\n雪の結晶とミスルトー\n私が行くところすべてに\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー","audio_url":"https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3","video_url": "https://platform2.cdn.acedata.cloud/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee.mp4?example=video-005","created_at":"2025-12-13T11:29:25.101Z","model":"chirp-v5","state":"succeeded","prompt":"クリスマスのための歌","style":"高揚感のある、オーケストラとベル、アコースティックギター","duration":129.92},{"id":"d1a3109d-799b-401e-b032-4b501bcf26f3","title":"雪の結晶とミスルトー","image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-071","image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-072","lyric":"[Verse]\nツリーにライトが再び絡まっている\n猫がリースを倒した\nオーブンでクッキーが焼けている\nでも私はまだ歯を見せて笑っている\n[Prechorus]\n雪が空にグリッターのように降っている\n今年は飛ぶような気がする\n[Chorus]\n雪の結晶とミスルトー\n私が行くところすべてに\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー\n[Verse 2]\nおばあちゃんが少し音程を外して歌っている\n子供たちが大声で笑っている\n犬が七面鳥の足を盗んだ\n混沌はクリスマスの群衆\n[Prechorus]\nでも火がパチパチと音を立てている\n暖かくて明るい\nそして今夜私の心はキャンドルのようだ\n[Chorus]\n雪の結晶とミスルトー\n私が行くところすべてに\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー","audio_url":"https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3","video_url":"","created_at":"2025-12-13T11:29:25.101Z","model":"chirp-v5","state":"running","prompt":"クリスマスのための歌","style":"高揚感のある、オーケストラとベル、アコースティックギター"}]} {"success":true,"task_id":"1af4b454-ce84-4512-a0a2-de3f8574ecd8","trace_id":"4440342a-41c4-4140-8bb1-3537a598ca2e","data":[{"id":"1f610752-f426-4fd5-89a8-ba2ad0370881","title":"雪の結晶とミスルトー","image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-073","image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-074","lyric":"[Verse]\n木にライトが再び絡まっている\n猫がリースを倒した\nオーブンでクッキーが焦げている\nでも私はまだ歯を見せて笑っている\n[Prechorus]\n雪が空にグリッターのように降っている\n今年は飛ぶような気がする\n[Chorus]\n雪の結晶とミスルトー\n私が行くところどこにでも\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー\n[Verse 2]\nおばあちゃんが少し音程を外して歌っている\n子供たちが大声で笑っている\n犬が七面鳥の足を盗んだ\n混沌はクリスマスの群衆\n[Prechorus]\nでも火がパチパチと音を立てている\n暖かくて明るい\nそして今夜私の心はキャンドルだ\n[Chorus]\n雪の結晶とミスルトー\n私が行くところどこにでも\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー","audio_url":"https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3","video_url":"","created_at":"2025-12-13T11:29:25.101Z","model":"chirp-v5","state":"succeeded","prompt":"クリスマスのための歌","style":"高揚感のある、オーケストラとベル、アコースティックギター","duration":129.92},{"id":"d1a3109d-799b-401e-b032-4b501bcf26f3","title":"雪の結晶とミスルトー","image_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-075","image_large_url": "https://cdn.acedata.cloud/e724d7f13d.png?example=image-076","lyric":"[Verse]\n木にライトが再び絡まっている\n猫がリースを倒した\nオーブンでクッキーが焦げている\nでも私はまだ歯を見せて笑っている\n[Prechorus]\n雪が空にグリッターのように降っている\n今年は飛ぶような気がする\n[Chorus]\n雪の結晶とミスルトー\n私が行くところどこにでも\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー\n[Verse 2]\nおばあちゃんが少し音程を外して歌っている\n子供たちが大声で笑っている\n犬が七面鳥の足を盗んだ\n混沌はクリスマスの群衆\n[Prechorus]\nでも火がパチパチと音を立てている\n暖かくて明るい\nそして今夜私の心はキャンドルだ\n[Chorus]\n雪の結晶とミスルトー\n私が行くところどこにでも\n私は知っている\n愛が贈り物\nその輝き\n雪の結晶とミスルトー","audio_url":"https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3","video_url":"","created_at":"2025-12-13T11:29:25.101Z","model":"chirp-v5","state":"succeeded","prompt":"クリスマスのための歌","style":"高揚感のある、オーケストラとベル、アコースティックギター","duration":127.16}]} ``` 得られた結果は基本的な呼び出しと似ており、上記の複数の結果はストリーミング呼び出しを実現しています。 ## エラーハンドリング エラーが発生した場合、次のようなエラーメッセージが表示されます： ```json theme={null} { "success": false, "error": { "code": "forbidden", "message": "曲の説明にアーティスト名が含まれています: eminem" }, "trace_id": "9bb7c2f4-3b7b-4965-b50a-f663874b1b6f", "task_id": "9bb3a2a6-c438-436d-a9f3-fa466abc077c" } ``` 以下はHTTPステータスコード、`error.code`、`error.message`のリストです： > 説明：異なる上流アカウントの制限とエラーメッセージは異なる場合があります。通常、`chirp-v3-5`/`chirp-v4`の`style`制限は低く（200）、`chirp-v4-5`以上は通常1000までサポートします。古い上流にヒットした場合、`Tags too long.`や`style must be less than or equal 120`などの互換性のあるメッセージが表示されることがあります。 | ステータスコード | `error.code` | `error.message` | | -------- | ------------- | ------------------------------------------ | | 400 | `bad_request` | `曲のIDが存在しないか、オフラインになっています。` | | 400 | `bad_request` | `プロンプトが長すぎます。` | | 400 | `bad_request` | `タグが長すぎます。` | | 400 | `bad_request` | `アップロードされた音声が既存の作品と一致しています。` | | 400 | `bad_request` | `インストゥルメンタルはブール値でなければなりません。` | | 400 | `bad_request` | `タイトルが長すぎます。` | | 400 | `bad_request` | `トピックが長すぎます。` | | 400 | `bad_request` | `style must be less than or equal 120` | | 400 | `bad_request` | `custom must be a boolean` | | 400 | `bad_request` | `audio_idは音声を拡張する際に必要です。` | | 400 | `bad_request` | `continue_atは音声を拡張する際に必要です。` | | 400 | `bad_request` | `continue_atは0より大きい数でなければなりません。` | | 400 | `bad_request` | `lyricは音声を拡張する際にインストゥルメンタルがfalseの場合に必要です。` | | 400 | `bad_request` | `プロンプトは音声を生成する際に必要です。` | | 400 | `bad_request` | `lyricはカスタム音声を生成する際に必要です。` | | 403 | `forbidden` | `プロンプトが不正な可能性があります。` | | 403 | `forbidden` | `プロンプトが著作権で保護されている可能性があります。` | | 403 | `forbidden` | `プロンプトに不適切な素材が含まれています。` | | 403 | `forbidden` | `曲の説明がモデレーションのためにフラグが立てられました。` | | 403 | `forbidden` | `曲の説明にアーティスト名が含まれています。` | | 403 | `forbidden` | `タグにアーティスト名が含まれています。` | | 403 | `forbidden` | `歌詞に著作権で保護された素材が含まれています。` | | 403 | `forbidden` | `曲の説明にプロデューサータグが含まれています。` | | 403 | `forbidden` | `一般的なopenAIエラー` | | 403 | `forbidden` | `プロンプトがモデレーションのためにフラグが立てられました。` | | 500 | `api_error` | `曲の説明から歌詞を生成できませんでした。` | | 500 | `api_error` | `不明なエラーでジョブが失敗しました。` | | 500 | `api_error` | `システムに利用可能なワーカーがいません。` | | 500 | `api_error` | `サービスがメンテナンス中で、生成が一時停止しています。` | | 504 | `timeout` | `音声生成を待っている間にタイムアウトしました。` |