申请流程
要使用 API，需要先到 Producer Audios Generation API 对应页面申请对应的服务，进入页面之后，点击「Acquire」按钮，如图所示：
如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。
在首次申请时会有免费额度赠送，可以免费使用该 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.5callback_url：需要回调结果的 URL。instrumental：是否为无歌词模式。
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，同时填入相应的参数，具体的内容如图所示：
内容如下：
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.