Producer Audios Generation API 集成指南

本文将介绍如何集成 Producer Audios Generation API，该 API 允许用户通过自定义参数生成官方音乐。此 API 非常适合音乐创作者、开发者及相关领域的专业人员，帮助他们快速生成所需的音乐作品。

环境准备/前置条件

在使用 API 之前，您需要完成以下准备工作：

注册并登录 Ace Data Cloud 账户。
获取 API 密钥，用于后续请求的身份验证。

申请流程

首先，您需要在 Producer Audios Generation API 页面申请相应的服务。进入页面后，点击"获取"按钮，如下图所示：

如果您尚未登录或注册，系统会自动引导您进行注册或登录。完成后，您将自动返回到当前页面。首次申请者将获得免费的配额，以便您可以免费使用该 API。

基本用法

您可以输入任何文本以生成歌曲。例如，如果您想生成一首关于圣诞节的歌曲，可以输入 a song for Christmas，如下图所示：

在请求头中，您需要设置以下内容：

accept: 您希望接收的响应格式，填入 application/json，表示 JSON 格式。
authorization: 调用 API 的密钥，申请后可直接选择。

请求体中的参数包括：

action: 此音乐生成任务的操作，生成歌曲时填入 generate。
model: 用于创建歌曲的模型，目前主要包括：FUZZ-2.0 Pro 、FUZZ-2.0等。
lyric: 歌词内容。
其他参数可参考文档中的详细描述。

选择完参数后，您可以看到右侧生成的相应代码，如下图所示：

点击"尝试"按钮进行测试，结果如下：

json 复制代码

{
  "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://storage.googleapis.com/corpusant-app-public/riffs/a853673e-615c-42ae-bdff-16b1add94861/image/6c947f13-a3c5-4b9c-8609-5639c37cdc2d.jpg",
      "lyric": "[Instrumental]",
      "audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/a853673e-615c-42ae-bdff-16b1add94861/audio/6c947f13-a3c5-4b9c-8609-5639c37cdc2d.m4a",
      "state": "succeeded",
      "duration": "181.3014058956916"
    }
  ]
}

返回结果中包含多个字段，详细字段说明可以参考文档。

自定义生成

如果您想自定义歌词，可以直接在 lyric 字段中输入歌词文本，如下所示：

复制代码

[Verse]Woke up with the sun in my eyes...

在填写参数时，需要指定以下内容：

lyric: 歌词文本
custom: 设置为 true，表示自定义生成。

填写完成后，生成的代码如下：

shell 复制代码

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..."
}'

常见问题

如何获取 API 密钥？
登录 Ace Data Cloud 后，进入 API 管理页面可申请 API 密钥。
API 的请求频率限制是多少？
不同的账户类型可能有不同的请求频率限制，请参考官方文档。
如何处理 API 返回的错误？
API 会返回相应的错误码和消息，建议根据响应的错误信息进行处理。

总结

通过本文档，您学习了如何使用 Producer Audios Generation API 生成音乐。如果您在集成或使用过程中有任何问题，请随时联系技术支持团队。

更多信息请访问以下链接： - Ace Data Cloud 官网 - API 文档

技术标签：#API #音乐生成 #AceDataCloud #技术教程 #Python