> ## 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. # Producer Audios Generation API 接続説明 > Producer Music Generation API guide - Ace Data Cloud 本文では、Producer Audios Generation API の接続説明を紹介します。これは、カスタムパラメータを入力することで、Producer の公式音楽を生成することができます。 ## 申請プロセス Producer 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) で一般残高をチャージできます。 > 📘 完全なドキュメント：[Producer Audios Generation API →](https://platform.acedata.cloud/documents/producer-audios) ## 基本使用 どんな曲を考えても、任意のテキストを入力できます。例えば、クリスマスに関する曲を生成したい場合は、`a song for Christmas` と入力します。以下のように表示されます：

ここでは、リクエストヘッダーを設定しました。内容は以下の通りです： * `accept`：受け取りたいレスポンスの形式。ここでは `application/json`、つまり JSON 形式を指定します。 * `authorization`：API を呼び出すためのキー。申請後、直接ドロップダウンから選択できます。 また、リクエストボディのパラメータには以下が含まれます： * `action`：音楽生成タスクの行動。曲を生成する場合は `generate`。 * `model`：曲作成に使用するモデル。現在主に以下があります： **FUZZ-2.0 Pro**、**FUZZ-2.0**、**FUZZ-2.0 Raw**、**FUZZ-1.1 Pro**、**FUZZ-1.0 Pro**、**FUZZ-1.0**、**FUZZ-1.1**、**FUZZ-0.8**。 * `lyric`：曲の歌詞内容。 * `custom`：カスタム方式で曲を生成するかどうか。 * `prompt`：インスピレーションモードでのヒントワード。 * `title`：曲のタイトル情報。 * `audio_id`：参考曲の ID。続き書きやコピーなどの操作に使用。 * `continue_at`：指定した秒数から曲を続ける。 * `replace_section_start`/`replace_section_end`：置き換えセクションの開始・終了時間（単位：秒）。 * `lyrics_strength`：歌詞の強度。音声生成における歌詞の影響度を示し、0-1 の間で選択可能。デフォルトは 0.7。 * `sound_strength`：音声ヒントワードの強度。0.2-1 の間で選択可能。デフォルトは 0.7。 * `cover_strength`：カバー強度。0.2-1 の間で選択可能。デフォルトは 1。 * `weirdness`：スタイルの奇抜さ。0-1 の間で選択可能。デフォルトは 0.5。 * `callback_url`：結果をコールバックする URL。 * `async`：オプション。`true` に設定すると、インターフェースはすぐに `task_id` を返し、`callback_url` を提供する必要がなく、その後、対応するタスククエリインターフェースをポーリングして結果を取得します。 * `instrumental`：歌詞なしモードかどうか。 選択後、右側にも対応するコードが生成されていることがわかります。以下のように表示されます：

「Try」ボタンをクリックするとテストが行えます。上の図のように、以下のような結果が得られました： ```json theme={null} { "success": true, "task_id": "82fd443a-903a-4f18-8028-12d2f8a0a4be", "trace_id": "d85839fa-0bb1-42da-a9fc-cd582c29027d", "data": [ { "id": "6c947f13-a3c5-4b9c-8609-5639c37cdc2d", "title": "Untitled", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Instrumental]", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": null, "image_id": "6c947f13-a3c5-4b9c-8609-5639c37cdc2d", "topic": null, "seed": "2450882164", "sound": "A song for Christmas", "created_at": "2025-12-30T17:18:23.232911Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "181.3014058956916" } ] } ``` 返された結果には複数のフィールドがあり、以下のように説明されます： * `success`：この時点での音楽生成タスクの状態。 * `data`：この音楽タスクの結果 * `id`：この音楽生成タスクの ID。 * `sound`：この音楽生成タスクのヒントワード。 * `seed`：この音楽生成タスクのシード値。 * `audio_url`：この音楽生成タスクの音声リンク。 * `image_url`：この音楽生成タスクのカバーリンク。 * `image_id`：この音楽生成タスクのカバー ID。 * `state`：この音楽生成タスクの状態。 * `duration`：この音楽の長さ情報。 * `progress`：この音楽タスクの進捗値。 * `model`：この音楽生成タスクで使用されたモデル情報。 * `lyric`：この音楽生成タスクの歌詞情報。 生成したい音楽情報が得られたことがわかります。結果の `data` にある音楽リンクアドレスを取得することで、生成された Producer 音楽を入手できます。 また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURL のコードは以下の通りです： ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "generate", "model": "FUZZ-2.0 Pro", "prompt": "A song for Christmas" }' ``` ## カスタム生成 歌詞をカスタム生成したい場合は、歌詞を入力できます： この時、`lyric` フィールドには以下のような内容を渡すことができます： ``` [Verse]Woke up with the sun in my eyesNo clouds above just blue in the skiesShoes on my feet I’m ready to runEvery step feels like a loaded gun[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high[Verse 2]Dancing through the city streetsA rhythm pounding in my heartbeatStrangers smile it’s catching onThis world’s a stage we’re all a song[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high[Bridge]Throw your worries out the doorLet them sink to the ocean floorWe’re alive and it’s enoughLife is messy but it’s love[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high ``` 次に、歌詞、タイトル、スタイルに基づいてカスタム生成された曲を指定することができます。 * lyric：歌詞テキスト * custom：`true`と記入するとカスタム生成を意味し、このパラメータのデフォルトはfalseで、`prompt`生成を意味します。 * title：曲のタイトル。 記入例は以下の通りです：

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

対応するコード： ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "generate", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high", "custom": true }' ``` テストが許可されており、生成された効果は類似のものです。 ```json theme={null} { "success": true, "task_id": "9f58bbd4-855a-4233-ac45-b63bf9168e02", "trace_id": "145ad117-6ce7-42dd-af12-70751c5284fc", "data": [ { "id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32", "title": "Woke up with the sun in my eyes", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high", "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3", "video_url": null, "image_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32", "topic": null, "seed": "3789209121", "sound": "", "created_at": "2025-12-30T17:26:46.357055Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "153.80897959183673" } ] } ``` ## カバー曲 既に生成された曲をカバーする操作を行いたい場合は、上記で生成された曲を入力してカバーを行います。次に、歌詞とタイトルに基づいてカスタム生成を行います。 自分がアップロードした曲を続けてカバーしたい場合は、`action`パラメータを`upload_cover`に設定し、続けてカバーするカスタムアップロードの曲IDを入力します。曲IDの取得は[Producer Upload API](https://platform.acedata.cloud/documents/producer-upload)を使用して行います。以下の画像のように：

次の内容を指定できます： * action：今回の曲タスクの行動、現在サポートされているのは：generate、cover、extend、upload\_cover、upload\_extend、replace\_section、swap\_vocals、swap\_instrumentals、variation、今回のカバーには`cover`パラメータを使用します。 * lyric：歌詞テキスト * title：曲のタイトル。 * custom：カスタムモード生成を使用するかどうか、デフォルトはfalseです。 * audio\_id：カバーする曲の曲ID。 記入例は以下の通りです：

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

対応するコード： ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "cover", "model": "FUZZ-2.0 Pro", "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high", "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32", "instrumental": false, "custom": true, "title": "Cover" }' ``` テストが許可されており、生成された効果は類似のものです。 ```json theme={null} { "success": true, "task_id": "dbca350e-6fb9-46ca-9c7e-4c1a9080806f", "trace_id": "a39e0fff-ced8-4b31-ae23-aef3badd90fa", "data": [ { "id": "e52dd729-38b4-4c2f-9031-59eb7953c593", "title": "カバー", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\n太陽が目に入って目が覚めた\n雲はなく、空は青い\n足元に靴を履いて、走る準備ができた\n一歩一歩が弾薬を込めた銃のように感じる\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影はない、嘘もない\nただ私を高く持ち上げる真実だけ\n[Verse 2]\n街の通りを踊りながら\n心臓の鼓動にリズムが響く\n見知らぬ人が笑って、それが広がっていく\nこの世界は舞台、私たちは皆歌だ\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影はない、嘘もない\nただ私を高く持ち上げる真実だけ\n[Bridge]\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": null, "image_id": "e52dd729-38b4-4c2f-9031-59eb7953c593", "topic": null, "seed": "358803418", "sound": "", "created_at": "2025-12-30T17:32:32.951948Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "成功", "duration": "153.0659410430839" } ] } ``` ## 曲の続き 曲を続けたい場合は、`action`パラメータの値を`extend`に設定する必要があります。次に、歌詞、タイトル、スタイルに基づいてカスタマイズして曲を生成します。 自分がアップロードした曲を続けたい場合は、`action`パラメータを`upload_extend`に設定し、続けてカスタマイズしたいアップロードした曲のIDを入力します。曲のIDは、[Producer Upload API](https://platform.acedata.cloud/documents/producer-upload)を使用して取得します。以下の画像のように：

記入例は以下の通りです：

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

対応するコード： ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "extend", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Verse]\n太陽が目に入って目が覚めた\n雲はなく、空は青い\n足元に靴を履いて、走る準備ができた\n一歩一歩が弾薬を込めた銃のように感じる\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影はない、嘘もない\nただ私を高く持ち上げる真実だけ\n[Verse 2]\n街の通りを踊りながら\n心臓の鼓動にリズムが響く\n見知らぬ人が笑って、それが広がっていく\nこの世界は舞台、私たちは皆歌だ\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影はない、嘘もない\nただ私を高く持ち上げる真実だけ\n[Bridge]\n心配事をドアの外に投げ捨てて\nそれを海の底に沈めて\n私たちは生きていて、それで十分\n人生は混沌としているが、それは愛だ\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影はない、嘘もない\nただ私を高く持ち上げる真実だけ", "continue_at": 3, "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32", "custom": true, "title": "拡張", "weirdness": 0.3, "sound_strength": 0.3, "lyrics_strength": 0.6 }' ``` テストが許可されている場合、生成された効果は似たようなものになります。 ```json theme={null} { "success": true, "task_id": "834983cb-d62d-4750-b1aa-461da137e51f", "trace_id": "6923eee2-7403-432c-8bd1-e471086385b0", "data": [ { "id": "d9ebc609-fb65-4a23-b914-c074747af6a4", "title": "拡張", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\n[Verse]\n太陽が目に入って目が覚めた\n雲はなく、空は青い\n足元に靴を履いて、走る準備ができた\n一歩一歩が弾薬を込めた銃のように感じる\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影はない、嘘もない\nただ私を高く持ち上げる真実だけ\n[Verse 2]\n街の通りを踊りながら\n心臓の鼓動にリズムが響く\n見知らぬ人が笑って、それが広がっていく\nこの世界は舞台、私たちは皆歌だ\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影はない、嘘もない\nただ私を高く持ち上げる真実だけ\n[Bridge]\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": null, "image_id": "d9ebc609-fb65-4a23-b914-c074747af6a4", "topic": null, "seed": "4294469624", "sound": "", "created_at": "2025-12-30T17:36:14.520928Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "成功", "duration": "173.87102040816328" } ] } ``` ## 音楽の変化 前の曲のseed値に基づいて、似たような効果の新しい音楽を生成したい場合は、`action`パラメータの値を`variation`に設定する必要があります。次に、似たような効果の新しい音楽をカスタマイズして生成できます。 記入例は以下の通りです：

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

対応するコード： ```shell theme={null} # ここにコードを記入 ``` ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "variation", "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Verse]\n太陽が目に入って目が覚めた\n雲はなく、空は青い\n足元に靴を履いて、走る準備ができた\n一歩一歩が弾薬を込めた銃のように感じる\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影も嘘もない\nただ私を高く持ち上げる真実だけ\n[Verse 2]\n街の通りを踊りながら\n心臓の鼓動にリズムが響く\n見知らぬ人が微笑んで、それが広がっていく\nこの世界は舞台、私たちは皆歌だ\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影も嘘もない\nただ私を高く持ち上げる真実だけ\n[Bridge]\n心配事をドアの外に投げ捨てて\nそれを海の底に沈めて\n私たちは生きていて、それで十分\n人生は混沌としているが、それは愛だ\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影も嘘もない\nただ私を高く持ち上げる真実だけ", "custom": true }' ``` ```json theme={null} { "success": true, "task_id": "3a74da6d-a37d-4b5d-b116-821f455bce39", "trace_id": "8e28cce0-0400-4bfd-83db-6d27f97422c7", "data": [ { "id": "c14ca458-cd5a-4700-83d4-5249e15f2707", "title": "太陽が目に入って目が覚めた", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\n太陽が目に入って目が覚めた\n雲はなく、空は青い\n足元に靴を履いて、走る準備ができた\n一歩一歩が弾薬を込めた銃のように感じる\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影も嘘もない\nただ私を高く持ち上げる真実だけ\n[Verse 2]\n街の通りを踊りながら\n心臓の鼓動にリズムが響く\n見知らぬ人が微笑んで、それが広がっていく\nこの世界は舞台、私たちは皆歌だ\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影も嘘もない\nただ私を高く持ち上げる真実だけ\n[Bridge]\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": null, "image_id": "c14ca458-cd5a-4700-83d4-5249e15f2707", "topic": null, "seed": "2082104582", "sound": "", "created_at": "2025-12-30T17:48:40.135187Z", "model": "FUZZ-2.0", "progress": "100%", "state": "succeeded", "duration": "173.12798185941043" } ] } ``` ## 置き換えセクション もし曲のセクションを置き換えたい場合は、`action`パラメータの値を`replace_section`に設定する必要があります。次に、歌詞やタイトルに基づいてカスタマイズされた曲を生成します。 自分がアップロードした曲のセクションを続けて置き換えたい場合は、`action`パラメータを`upload_replace_section`に設定し、続けてカスタマイズしたアップロード曲のIDを入力します。曲のIDは[Producer Upload API](https://platform.acedata.cloud/documents/producer-upload)を使用して取得します。以下の画像のように：

記入例は以下の通りです：

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

対応するコード： ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "replace_section", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Verse]\\n太陽が目に入って目が覚めた\\n雲はなく、空は青い\\n足元に靴を履いて、走る準備ができた\\n一歩一歩が弾薬を込めた銃のように感じる\\n[Chorus]\\n幸せな日々がやってくる\\n私の肌の下の喜びを感じて\\nもう影も嘘もない\\nただ私を高く持ち上げる真実だけ\\n[Verse 2]\\n街の通りを踊りながら\\n心臓の鼓動にリズムが響く\\n見知らぬ人が微笑んで、それが広がっていく\\nこの世界は舞台、私たちは皆歌だ\\n[Chorus]\\n幸せな日々がやってくる\\n私の肌の下の喜びを感じて\\nもう影も嘘もない\\nただ私を高く持ち上げる真実だけ\\n[Bridge]\\n心配事をドアの外に投げ捨てて\\nそれを海の底に沈めて\\n私たちは生きていて、それで十分\\n人生は混沌としているが、それは愛だ\\n[Chorus]\\n幸せな日々がやってくる\\n私の肌の下の喜びを感じて\\nもう影も嘘もない\\nただ私を高く持ち上げる真実だけ", "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4", "replace_section_start": 3, "replace_section_end": 70, "custom": true }' ``` テストは許可されており、生成された効果は類似のものです。 ```json theme={null} { "success": true, "task_id": "3cb5ae96-01b0-4a37-afb0-e582608af56f", "trace_id": "3ebc6f63-5093-4499-bf9b-95c239e0da4f", "data": [ { "id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f", "title": "太陽の光で目が覚めた", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\\n太陽の光で目が覚めた\\n雲一つなく空は青い\\n足元に靴を履いて走る準備ができた\\n一歩一歩が弾薬を込めた銃のように感じる\\n[Chorus]\\n幸せな日々がやってくる\\n肌の下の喜びを感じて\\nもう影も嘘もない\\nただ私を高く持ち上げる真実だけ\\n[Verse 2]\\n街の通りを踊りながら\\n心臓の鼓動に合わせたリズム\\n見知らぬ人が微笑んで、それが広がっていく\\nこの世界は舞台、私たちは皆歌\\n[Chorus]\\n幸せな日々がやってくる\\n肌の下の喜びを感じて\\nもう影も嘘もない\\nただ私を高く持ち上げる真実だけ\\n[Bridge]\\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": null, "image_id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f", "topic": null, "seed": "14887454", "sound": "", "created_at": "2025-12-30T18:01:19.907443Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "174.6140589569161" } ] } ``` ## 伴奏翻版 公式の伴奏翻版操作を使用したい場合は、`action`パラメータの値を`swap_instrumentals`に設定します。次に、歌詞とタイトルに基づいて曲をカスタマイズして生成します。 記入例は以下の通りです：

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

対応するコード： ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "swap_instrumentals", "model": "FUZZ-2.0 Pro", "weirdness": 0.6, "prompt": "Happy", "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4" }' ``` テストが許可されており、生成された効果は似たようなものです。 ```json theme={null} { "success": true, "task_id": "d17d8376-3a58-451d-a976-404719bac11d", "trace_id": "ab596807-910a-4e30-bae2-4647895f7d0b", "data": [ { "id": "22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b", "title": "拡張 (サウンドスワップ)", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\n太陽の光で目が覚めた\n雲一つなく空は青い\n足元に靴を履いて走る準備ができた\n一歩一歩が弾薬を込めた銃のように感じる\n[Chorus]\n幸せな日々がやってくる\n肌の下の喜びを感じて\nもう影も嘘もない\nただ私を高く持ち上げる真実だけ\n[Verse 2]\n街の通りを踊りながら\n心臓の鼓動に合わせたリズム\n見知らぬ人が微笑んで、それが広がっていく\nこの世界は舞台、私たちは皆歌\n[Chorus]\n幸せな日々がやってくる\n肌の下の喜びを感じて\nもう影も嘘もない\nただ私を高く持ち上げる真実だけ\n[Bridge]\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": null, "image_id": "22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b", "topic": null, "seed": "2157878068", "sound": "Happy", "created_at": "2025-12-30T18:09:49.594800Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "172.3849433106576" } ] } ``` ## 人声翻版 公式の人声翻版操作を使用したい場合は、`action`パラメータの値を`swap_vocals`に設定します。次に、歌詞、タイトル、スタイルに基づいて曲をカスタマイズして生成します。 記入例は以下の通りです：

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

対応するコード： ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "swap_vocals", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Verse]\n太陽の光で目が覚めた\n雲一つなく空は青い\n足元に靴を履いて走る準備ができた\n一歩一歩が弾薬を込めた銃のように感じる\n[Chorus]\n幸せな日々がやってくる\n肌の下の喜びを感じて\nもう影も嘘もない\nただ私を高く持ち上げる真実だけ\n[Verse 2]\n街の通りを踊りながら\n心臓の鼓動に合わせたリズム\n見知らぬ人が微笑んで、それが広がっていく\nこの世界は舞台、私たちは皆歌\n[Chorus]\n幸せな日々がやってくる\n肌の下の喜びを感じて\nもう影も嘘もない\nただ私を高く持ち上げる真実だけ\n[Bridge]\n心配事をドアの外に投げ捨てて\nそれを海の底に沈めて\n私たちは生きていて、それで十分\n人生は混沌としているけれど、それは愛\n[Chorus]\n幸せな日々がやってくる\n肌の下の喜びを感じて\nもう影も嘘もない\nただ私を高く持ち上げる真実だけ", "weirdness": 0.6, "lyrics_strength": 0.8, "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4", "custom": true }' ``` テストが許可されており、生成された効果は似たようなものです。 ```json theme={null} { "success": true, "task_id": "a903ac38-f129-4f85-9181-b1dc5579bd32", "trace_id": "9953af52-45e0-4808-bf13-88f0b21262c1", "data": [ { "id": "7b2d653b-aaaa-41b0-b737-aee4c4c5693b", "title": "太陽の光で目が覚めた", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\n太陽の光で目が覚めた\n雲一つない青空\n足元に靴を履いて走る準備ができた\n一歩一歩が弾薬のように感じる\n[Chorus]\n幸せな日々がやってくる\n肌の下の喜びを感じて\nもう影も嘘もない\nただ私を高く持ち上げる真実だけ\n[Verse 2]\n街の通りを踊りながら\n心臓の鼓動にリズムが響く\n見知らぬ人が笑って、それが広がる\nこの世界は舞台、私たちは皆一つの歌\n[Chorus]\n幸せな日々がやってくる\n肌の下の喜びを感じて\nもう影も嘘もない\nただ私を高く持ち上げる真実だけ\n[Bridge]\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": null, "image_id": "7b2d653b-aaaa-41b0-b737-aee4c4c5693b", "topic": null, "seed": "2484735707", "sound": "", "created_at": "2025-12-30T18:13:01.349875Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "173.12798185941043" } ] } ``` ## 歌詞と曲の分離 公式の歌詞と曲の分離操作を使用したい場合は、`action`パラメータの値を`stems`に設定し、次に曲のIDに基づいて歌詞と曲を分離します。 記入例は以下の通りです：

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

対応するコード： ```shell theme={null} curl -X POST 'https://api.acedata.cloud/producer/audios' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "action": "stems", "audio_id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f" }' ``` テストが許可されている場合、生成された効果は似たようなものになります。 ```json theme={null} { "success": true, "task_id": "561ac695-b4aa-47cf-978d-fb7be2b9ebfc", "trace_id": "66d0d397-2987-4bde-84fb-a60d0023b217", "data": [ { "title": "太陽の光で目が覚めた", "lyric": "", "stems_url": "https://platform.cdn.acedata.cloud/producer/561ac695-b4aa-47cf-978d-fb7be2b9ebfc.zip", "model": "", "progress": "100%", "state": "succeeded" } ] } ``` ## 非同期コールバック Producer Audios Generation APIの生成時間は時々長くなることがあるため、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/](https://webhook.site/)を使用します。このサイトを開くとWebhook URLが得られます。以下のように示されています： ![](https://cdn.acedata.cloud/tbcnai.png) このURLをコピーすればWebhookとして使用できます。このサンプルは[https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1](https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1)です。 次に、`callback_url`フィールドを上記のWebhook URLに設定し、対応するパラメータを入力します。具体的な内容は以下のようになります：

実行をクリックすると、すぐに結果が得られます。以下の通りです： ``` { "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad" } ``` 少し待つと、[https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1](https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1)で生成タスクの結果を観察できます。以下のように示されています： ![](https://cdn.acedata.cloud/k0kf0y.png) 内容は以下の通りです： ```json theme={null} { "success": true, "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad", "trace_id": "1da03537-4eb8-410d-b849-43f03085a3bb", "data": [ { "id": "1dd08826-478e-43a6-868f-aff5ababac2c", "title": "太陽の光で目が覚めた", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\n太陽の光で目が覚めた\n雲はなく、空は青い\n足元に靴を履いて、走る準備ができた\n一歩一歩が弾薬を込めた銃のように感じる\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影はない、嘘もない\nただ私を高く持ち上げる真実だけ\n[Verse 2]\n街の通りを踊りながら\n心臓の鼓動にリズムが響く\n見知らぬ人が笑って、それが広がる\nこの世界は舞台、私たちは皆歌だ\n[Chorus]\n幸せな日々がやってくる\n私の肌の下の喜びを感じて\nもう影はない、嘘もない\nただ私を高く持ち上げる真実だけ\n[Bridge]\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": null, "image_id": "1dd08826-478e-43a6-868f-aff5ababac2c", "topic": null, "seed": "1490770667", "sound": "", "created_at": "2025-12-30T18:36:00.994141Z", "model": "FUZZ-2.0 Pro", "progress": "100%", "state": "succeeded", "duration": "135.2330158730159" } ] } ``` 結果には `task_id` フィールドが含まれており、他のフィールドは前述の内容と似ています。このフィールドを通じてタスクの関連付けが可能です。 ## エラーハンドリング APIを呼び出す際にエラーが発生した場合、APIは対応するエラーコードとメッセージを返します。例えば： * `400 token_mismatched`：不正なリクエスト、パラメータが不足しているか無効である可能性があります。 * `400 api_not_implemented`：不正なリクエスト、パラメータが不足しているか無効である可能性があります。 * `401 invalid_token`：認証されていない、無効または不足している認証トークン。 * `429 too_many_requests`：リクエストが多すぎます、レート制限を超えました。 * `500 api_error`：内部サーバーエラー、サーバーで何かがうまくいきませんでした。 ### エラー応答の例 ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "取得に失敗しました" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## 結論 この文書を通じて、Producer Audios Generation APIを使用して入力プロンプトから音楽を生成する方法を理解しました。この文書がAPIの接続と使用に役立つことを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。