Skip to main content
本文では、Producer Audios Generation API の接続説明を紹介します。これは、カスタムパラメータを入力することで、Producer の公式音楽を生成することができます。

​
申請プロセス

Producer Audios Generation API を使用するには、まず Ace Data Cloud コンソール にアクセスして、API トークンを取得し、保管してください。 まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。 1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソール で一般残高をチャージできます。
📘 完全なドキュメント：Producer Audios Generation API →

​
基本使用

どんな曲を考えても、任意のテキストを入力できます。例えば、クリスマスに関する曲を生成したい場合は、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」ボタンをクリックするとテストが行えます。上の図のように、以下のような結果が得られました：
返された結果には複数のフィールドがあり、以下のように説明されます：
  • success：この時点での音楽生成タスクの状態。
    • data：この音楽タスクの結果
      • id：この音楽生成タスクの ID。
      • sound：この音楽生成タスクのヒントワード。
      • seed：この音楽生成タスクのシード値。
      • audio_url：この音楽生成タスクの音声リンク。
      • image_url：この音楽生成タスクのカバーリンク。
      • image_id：この音楽生成タスクのカバー ID。
      • state：この音楽生成タスクの状態。
      • duration：この音楽の長さ情報。
      • progress：この音楽タスクの進捗値。
      • model：この音楽生成タスクで使用されたモデル情報。
      • lyric：この音楽生成タスクの歌詞情報。
生成したい音楽情報が得られたことがわかります。結果の data にある音楽リンクアドレスを取得することで、生成された Producer 音楽を入手できます。 また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURL のコードは以下の通りです：

​
カスタム生成

歌詞をカスタム生成したい場合は、歌詞を入力できます： この時、lyric フィールドには以下のような内容を渡すことができます：
次に、歌詞、タイトル、スタイルに基づいてカスタム生成された曲を指定することができます。
  • lyric：歌詞テキスト
  • custom：trueと記入するとカスタム生成を意味し、このパラメータのデフォルトはfalseで、prompt生成を意味します。
  • title：曲のタイトル。
記入例は以下の通りです：

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

対応するコード：
テストが許可されており、生成された効果は類似のものです。

​
カバー曲

既に生成された曲をカバーする操作を行いたい場合は、上記で生成された曲を入力してカバーを行います。次に、歌詞とタイトルに基づいてカスタム生成を行います。 自分がアップロードした曲を続けてカバーしたい場合は、actionパラメータをupload_coverに設定し、続けてカバーするカスタムアップロードの曲IDを入力します。曲IDの取得はProducer Upload APIを使用して行います。以下の画像のように：

次の内容を指定できます：
  • action：今回の曲タスクの行動、現在サポートされているのは：generate、cover、extend、upload_cover、upload_extend、replace_section、swap_vocals、swap_instrumentals、variation、今回のカバーにはcoverパラメータを使用します。
  • lyric：歌詞テキスト
  • title：曲のタイトル。
  • custom：カスタムモード生成を使用するかどうか、デフォルトはfalseです。
  • audio_id：カバーする曲の曲ID。
記入例は以下の通りです：

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

対応するコード：
テストが許可されており、生成された効果は類似のものです。

​
曲の続き

曲を続けたい場合は、actionパラメータの値をextendに設定する必要があります。次に、歌詞、タイトル、スタイルに基づいてカスタマイズして曲を生成します。 自分がアップロードした曲を続けたい場合は、actionパラメータをupload_extendに設定し、続けてカスタマイズしたいアップロードした曲のIDを入力します。曲のIDは、Producer Upload APIを使用して取得します。以下の画像のように：

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

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

対応するコード：
テストが許可されている場合、生成された効果は似たようなものになります。

​
音楽の変化

前の曲のseed値に基づいて、似たような効果の新しい音楽を生成したい場合は、actionパラメータの値をvariationに設定する必要があります。次に、似たような効果の新しい音楽をカスタマイズして生成できます。 記入例は以下の通りです：

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

対応するコード：

​
置き換えセクション

もし曲のセクションを置き換えたい場合は、actionパラメータの値をreplace_sectionに設定する必要があります。次に、歌詞やタイトルに基づいてカスタマイズされた曲を生成します。 自分がアップロードした曲のセクションを続けて置き換えたい場合は、actionパラメータをupload_replace_sectionに設定し、続けてカスタマイズしたアップロード曲のIDを入力します。曲のIDはProducer Upload APIを使用して取得します。以下の画像のように：

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

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

対応するコード：
テストは許可されており、生成された効果は類似のものです。

​
伴奏翻版

公式の伴奏翻版操作を使用したい場合は、actionパラメータの値をswap_instrumentalsに設定します。次に、歌詞とタイトルに基づいて曲をカスタマイズして生成します。 記入例は以下の通りです：

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

対応するコード：
テストが許可されており、生成された効果は似たようなものです。

​
人声翻版

公式の人声翻版操作を使用したい場合は、actionパラメータの値をswap_vocalsに設定します。次に、歌詞、タイトル、スタイルに基づいて曲をカスタマイズして生成します。 記入例は以下の通りです：

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

対応するコード：
テストが許可されており、生成された効果は似たようなものです。

​
歌詞と曲の分離

公式の歌詞と曲の分離操作を使用したい場合は、actionパラメータの値をstemsに設定し、次に曲のIDに基づいて歌詞と曲を分離します。 記入例は以下の通りです：

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

対応するコード：
テストが許可されている場合、生成された効果は似たようなものになります。

​
非同期コールバック

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/を使用します。このサイトを開くとWebhook URLが得られます。以下のように示されています： このURLをコピーすればWebhookとして使用できます。このサンプルはhttps://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1です。 次に、callback_urlフィールドを上記のWebhook URLに設定し、対応するパラメータを入力します。具体的な内容は以下のようになります：

実行をクリックすると、すぐに結果が得られます。以下の通りです：
少し待つと、https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1で生成タスクの結果を観察できます。以下のように示されています： 内容は以下の通りです：
結果には task_id フィールドが含まれており、他のフィールドは前述の内容と似ています。このフィールドを通じてタスクの関連付けが可能です。

​
エラーハンドリング

APIを呼び出す際にエラーが発生した場合、APIは対応するエラーコードとメッセージを返します。例えば：
  • 400 token_mismatched：不正なリクエスト、パラメータが不足しているか無効である可能性があります。
  • 400 api_not_implemented：不正なリクエスト、パラメータが不足しているか無効である可能性があります。
  • 401 invalid_token：認証されていない、無効または不足している認証トークン。
  • 429 too_many_requests：リクエストが多すぎます、レート制限を超えました。
  • 500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。

​
エラー応答の例

​
結論

この文書を通じて、Producer Audios Generation APIを使用して入力プロンプトから音楽を生成する方法を理解しました。この文書がAPIの接続と使用に役立つことを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。