Skip to main content
本文将介绍一种 Producer Audios Generation API 对接说明，它是可以通过输入自定义参数来生成 Producer 官方的音乐。

​
申请流程

要使用 API，需要先到 Producer Audios Generation API 对应页面申请对应的服务，进入页面之后，点击「Acquire」按钮，如图所示： 如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。 在首次申请时会有免费额度赠送，可以免费使用该 API。

​
基本使用

想些什么歌曲，可以任意输入一段文字，比如我想生成一个关于圣诞的歌曲，就可以输入 a song for Christmas，如图所示：

可以看到这里我们设置了 Request Headers，包括：
  • accept：想要接收怎样格式的响应结果，这里填写为 application/json，即 JSON 格式。
  • authorization：调用 API 的密钥，申请之后可以直接下拉选择。
另外 Request Body 的参数包括：
  • 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。
  • 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 会立马返回一个结果，包含一个 task_id 的字段信息，代表当前的任务 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：Bad request, possibly due to missing or invalid parameters.
  • 400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.
  • 401 invalid_token：Unauthorized, invalid or missing authorization token.
  • 429 too_many_requests：Too many requests, you have exceeded the rate limit.
  • 500 api_error：Internal server error, something went wrong on the server.

​
错误响应示例

​
结论

通过本文档，您已经了解了如何使用 Producer Audios Generation API 可通过输入提示词来生成音乐。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。