Suno API API 价格与接入

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，用 GET /api/v1/jobs/recordInfo?taskId=... 轮询（见[“获取任务详情”](/cn/market/common/get-task-detail)）。Suno 音频类任务的结果在 data.response.data[]（audio_url、stream_audio_url、image_url、id、duration）。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

上传的音频文件 URL。必填。提供 `title`、`negative_tags`、`tags` 后，有源音频（`upload_url`）即可生成。

用于生成的AI模型版本。 - 可用选项： - **`V6_WILD`**：突破风格边界，带来更大胆、更独特的音乐表达。 - **`V6_MINI`**：轻量快速，兼顾音质与效率，灵感创作更简单。 - **`V6`**：更强的音乐表现力，更自然的人声与丰富细节

可选值："V6", "V6_WILD", "V6_MINI"

默认："V6"

生成音乐的标题。必填。将显示在播放器界面和文件名中。

从生成的音频中排除的音乐风格或特征。必填。用于避免特定不需要的音乐元素。

maxLength: 200

希望在生成音乐中包含的音乐风格或标签。必填。定义期望的音乐风格和特征。

maxLength: 1000

人声性别偏好。可选。'm' 表示男声，'f' 表示女声。根据实践，此参数只能加强概率，但不能保证一定遵循男女声的指令。

可选值："m", "f"

对指定风格的遵循强度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

控制实验性/创意偏离程度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

音频要素相对权重。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

生成音频的歌词。可选。 - V6、V6_MINI 和 V6_WILD：最多 5000 字符。 - 非必填。提供 `title`、`negative_tags`、`tags` 后，有源音频（`upload_url`）即可生成。

maxLength: 5000

控制生成结果的多样性和风格差异程度。可选。范围 0–4，取整数，默认值为 1。 - **`0`**：off（关），完全关闭，严格用同一风格 - **`1`**：normal（普通），默认值，在稳定性和多样性之间保持平衡 - **`2`**：high（高），生成风格差异明显的结果 - **`3`**：extra（额外），提供更高程度的变化，鼓励大胆探索不同风格 - **`4`**：max（最大），最大程度增加多样性，生成结果可能具有非常明显的风格差异

默认：1

minimum: 0

maximum: 4

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，用 GET /api/v1/jobs/recordInfo?taskId=... 轮询（见[“获取任务详情”](/cn/market/common/get-task-detail)）。Suno 音频类任务的结果在 data.response.data[]（audio_url、stream_audio_url、image_url、id、duration）。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

生成音频的提示词。可选。 - 仅在未传入 `lyrics` 时作为歌词使用。若已传入 `lyrics`，则不再将 `prompt` 当作歌词。 - V6、V6_MINI 和 V6_WILD：最多 5000 字符。

maxLength: 5000

用于生成的AI模型版本。 - 可用选项： - **`V6_WILD`**：突破风格边界，带来更大胆、更独特的音乐表达。 - **`V6_MINI`**：轻量快速，兼顾音质与效率，灵感创作更简单。 - **`V6`**：更强的音乐表现力，更自然的人声与丰富细节

可选值："V6", "V6_WILD", "V6_MINI"

默认："V6"

音乐的标题。必填。将显示在播放器界面和文件名中。

排除的音乐风格。必填。用于避免在生成的音乐中包含特定的风格或元素。

maxLength: 200

音乐的风格。必填。如爵士、电子、古典等音乐类型。

maxLength: 1000

人声性别偏好。可选。'm' 表示男声，'f' 表示女声。根据实践，此参数只能加强概率，但不能保证一定遵循男女声的指令。

可选值："m", "f"

对指定风格的遵循强度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

控制实验性/创意偏离程度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

音频要素相对权重。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

上传的音频文件 URL。必填。提供 `title`、`negative_tags`、`style` 后，有源音频（`upload_url`）即可生成。

生成音频的歌词。可选。 - 优先于 `prompt` 作为歌词。未传入时，若提供了 `prompt` 则使用 `prompt` 作为歌词。 - V6、V6_MINI 和 V6_WILD：最多 5000 字符。 - 非必填。提供 `title`、`negative_tags`、`style` 后，有源音频（`upload_url`）即可生成。

maxLength: 5000

控制生成结果的多样性和风格差异程度。可选。范围 0–4，取整数，默认值为 1。 - **`0`**：off（关），完全关闭，严格用同一风格 - **`1`**：normal（普通），默认值，在稳定性和多样性之间保持平衡 - **`2`**：high（高），生成风格差异明显的结果 - **`3`**：extra（额外），提供更高程度的变化，鼓励大胆探索不同风格 - **`4`**：max（最大），最大程度增加多样性，生成结果可能具有非常明显的风格差异

默认：1

minimum: 0

maximum: 4

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，用 GET /api/v1/jobs/recordInfo?taskId=... 轮询（见[“获取任务详情”](/cn/market/common/get-task-detail)）。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

风格描述。请用简洁明了的语言描述你期望生成的音乐风格。示例：'Pop, Mysterious'。

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

音乐生成任务的唯一标识符。应为"生成音乐"或"延长音乐"接口返回的task_id。转换分离后的音轨时，请改传人声和乐器分离任务的 task_id。

要转换的特定音频曲目的唯一标识符。此ID在音乐生成完成后的回调数据中返回。转换分离后的音轨时，填该音轨在分离结果中的 id（origin_data[].id）。

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，用 GET /api/v1/jobs/recordInfo?taskId=... 轮询（见[“获取任务详情”](/cn/market/common/get-task-detail)）。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

原音乐任务ID，应为音乐生成接口返回的task_id。

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

音乐生成任务的唯一标识符。应为"生成音乐"或"延长音乐"接口返回的task_id。

要可视化的特定音频曲目的唯一标识符。此ID在音乐生成完成后的回调数据中返回。

要在视频封面上显示的艺术家或创作者姓名。最多50个字符。这为音乐创作者创建署名。

maxLength: 50

要在视频底部显示为水印的网站或品牌。最多50个字符。适用于促销品牌或归属。

maxLength: 50

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，用 GET /api/v1/jobs/recordInfo?taskId=... 轮询（见[“获取任务详情”](/cn/market/common/get-task-detail)）。Suno 音频类任务的结果在 data.response.data[]（audio_url、stream_audio_url、image_url、id、duration）。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

要延长的音频曲目的唯一标识符。所有延长请求都必填。

延长音频的歌词。可选。 - 仅在未传入 `lyrics` 时作为歌词使用。若已传入 `lyrics`，则不再将 `prompt` 当作歌词。 - V6、V6_MINI 和 V6_WILD：最多 5000 字符。 - 非必填。有源音频（`audio_id`）即可生成。 - 若 `instrumental` 为 `true`，请勿传入此参数。

maxLength: 5000

延长音频的音乐风格规范。可选。 - 非必填。有源音频（`audio_id`）即可生成。 - 不同模型的字符限制： - **V6、V6_MINI 和 V6_WILD**：最多1000字符 - 通常应与原始音频的风格保持一致以获得最佳效果。

maxLength: 1000

延长音乐曲目的标题。可选。 - 最多 100 字符。 - 将显示在播放器界面和文件名中。

maxLength: 100

音频开始扩展的时间点（以秒为单位）。 - 取值范围：大于0且小于该生成音频的总时长。 - 指定从原始音频的哪个时间点开始进行扩展。

必填。请使用 V6、V6_MINI 或 V6_WILD。 - **`V6_WILD`**：突破风格边界，带来更大胆、更独特的音乐表达。 - **`V6_MINI`**：轻量快速，兼顾音质与效率，灵感创作更简单。 - **`V6`**：更强的音乐表现力，更自然的人声与丰富细节

可选值："V6", "V6_WILD", "V6_MINI"

从延长的音频中排除的音乐风格或特征。可选。用于避免特定不需要的特性。

人声性别偏好。可选。'm' 表示男声，'f' 表示女声。根据实践，此参数只能加强概率，但不能保证一定遵循男女声的指令。若 `instrumental` 为 `true`，则无需传入此参数。

可选值："m", "f"

对指定风格的遵循强度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

控制实验性/创意偏离程度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

音频要素相对权重。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

用于应用于生成音乐的 Persona ID 或 Voice ID。可选。使用此选项可将特定的 Persona 风格应用于您的音乐生成。 要生成 Persona ID，请使用 [生成 Persona]([see VezAPI documentation]) 端点，基于生成的音乐创建个性化的音乐 Persona。 要生成 Voice ID，请使用 [生成 Voice]([see VezAPI documentation]) 端点。

persona 模型 只有v5（已废弃）、v5.5（已废弃）、V6、V6_MINI、V6_WILD 的模型才可进行使用

可选值："style_persona", "voice_persona"

是否为纯音乐。若为真，则禁止传入 `lyrics`、`prompt` 和 `vocal_gender` 参数。

默认：false

延长音频的歌词。可选。 - 优先于 `prompt` 作为歌词。未传入时，若提供了 `prompt` 则使用 `prompt` 作为歌词。 - V6、V6_MINI 和 V6_WILD：最多 5000 字符。 - 非必填。有源音频（`audio_id`）即可生成。 - 若 `instrumental` 为 `true`，请勿传入此参数。

maxLength: 5000

控制生成结果的多样性和风格差异程度。可选。范围 0–4，取整数，默认值为 1。 - **`0`**：off（关），完全关闭，严格用同一风格 - **`1`**：normal（普通），默认值，在稳定性和多样性之间保持平衡 - **`2`**：high（高），生成风格差异明显的结果 - **`3`**：extra（额外），提供更高程度的变化，鼓励大胆探索不同风格 - **`4`**：max（最大），最大程度增加多样性，生成结果可能具有非常明显的风格差异

默认：1

minimum: 0

maximum: 4

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

对所需歌词内容的描述。具体说明您希望歌词中包含的主题、情绪、风格或故事元素。提示越详细，结果越好。最大字数限制为200字。

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，用 GET /api/v1/jobs/recordInfo?taskId=... 轮询（见[“获取任务详情”](/cn/market/common/get-task-detail)）。Suno 音频类任务的结果在 data.response.data[]（audio_url、stream_audio_url、image_url、id、duration）。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

要混音的音频文件 URL 数组。需传 2 个音频 URL，只取前 2 个。每个 URL 必须是可公开访问的。

minItems: 2

描述所需音频内容的提示词。可选。 - 仅在未传入 `lyrics` 时作为歌词使用。若已传入 `lyrics`，则不再将 `prompt` 当作歌词。 - V6、V6_MINI 和 V6_WILD：最多 5000 字符。

maxLength: 5000

生成音频的音乐风格规范。必填。 - 不同模型的字符限制： - **V6、V6_MINI 和 V6_WILD**：最多1000字符 - 常见示例：爵士乐、古典乐、电子乐、流行乐、摇滚乐、嘻哈等。

maxLength: 1000

生成音乐曲目的标题。必填。 - 不同模型的字符限制： - **V6、V6_MINI 和 V6_WILD**：最多100字符 - 将显示在播放器界面和文件名中。

必填。请使用 V6、V6_MINI 或 V6_WILD。 - **`V6_WILD`**：突破风格边界，带来更大胆、更独特的音乐表达。 - **`V6_MINI`**：轻量快速，兼顾音质与效率，灵感创作更简单。 - **`V6`**：更强的音乐表现力，更自然的人声与丰富细节

可选值："V6", "V6_MINI", "V6_WILD"

人声性别偏好。可选。使用 'm' 表示男声，'f' 表示女声。根据实践，此参数只能增加概率，但不能保证遵循男女声指令。

可选值："m", "f"

对指定风格的遵循强度。可选。范围 0–1，保留2位小数。

minimum: 0

maximum: 1

控制实验性/创意偏差。可选。范围 0–1，保留2位小数。

minimum: 0

maximum: 1

音频特征与其他因素的平衡权重。可选。范围 0–1，保留2位小数。

minimum: 0

maximum: 1

默认：20

minimum: 10

maximum: 360

混音音频的歌词。可选。 - 优先于 `prompt` 作为歌词。未传入时，若提供了 `prompt` 则使用 `prompt` 作为歌词。 - V6、V6_MINI 和 V6_WILD：最多 5000 字符。

maxLength: 5000

控制生成结果的多样性和风格差异程度。可选。范围 0–4，取整数，默认值为 1。 - **`0`**：off（关），完全关闭，严格用同一风格 - **`1`**：normal（普通），默认值，在稳定性和多样性之间保持平衡 - **`2`**：high（高），生成风格差异明显的结果 - **`3`**：extra（额外），提供更高程度的变化，鼓励大胆探索不同风格 - **`4`**：max（最大），最大程度增加多样性，生成结果可能具有非常明显的风格差异

默认：1

minimum: 0

maximum: 4

用于应用于生成音乐的 Persona ID 或 Voice ID。可选。使用此选项可将特定的 Persona 风格应用于您的音乐生成。 要生成 Persona ID，请使用 [生成 Persona]([see VezAPI documentation]) 端点，基于生成的音乐创建个性化的音乐 Persona。 要生成 Voice ID，请使用 [生成 Voice]([see VezAPI documentation]) 端点。

可选值："style_persona", "voice_persona"

默认："style_persona"

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

已完成的人声分离任务 ID。这应该是从人声与乐器分离端点返回的 task_id。

分离回调中 vocal_removal_info.origin_data[].id 的某一轨 id；不传则对全部音轨生成 MIDI。

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，用 GET /api/v1/jobs/recordInfo?taskId=... 轮询（见[“获取任务详情”](/cn/market/common/get-task-detail)）。Suno 音频类任务的结果在 data.response.data[]（audio_url、stream_audio_url、image_url、id、duration）。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

描述所需音频内容的提示词。可选。 - 自定义模式`custom_mode=true`：当提供 prompt 时，提示词将严格作为歌词使用并在生成的音轨中演唱；不同模型的字符限制如下： - 非自定义模式`custom_mode=false`：当提供 prompt 时，提示词作为核心创意，歌词将根据提示词自动生成，不严格匹配输入，最多 3000 字符。 生成时无需强制填写 prompt，但非自定义模式下`image_urls`、`video_urls`、`audio_urls`、`midi_urls`、`style`、`lyrics` 至少提供一项；自定义模式下 `style`、`lyrics`、`negative_tags`至少提供一项，所有相关输入均为空时将拒绝生成。

生成音频的音乐风格规范。 - 不同模型的字符限制： - **V6、V6_MINI 和 V6_WILD**：最多1000字符 - 常见示例：爵士乐、古典乐、电子乐、流行乐、摇滚乐、嘻哈等。

生成音乐曲目的标题。 - 在自定义模式（`custom_mode: true`）下必填。 - 最大长度：80字符。 - 将显示在播放器界面和文件名中。

确定是否启用高级参数自定义。 - 如果为 `true`：允许详细控制 - 如果为 `false`：简化模式

是否生成纯音乐（无人声）。各模式下的必填项见顶部“参数详情”。

必填。请使用 V6、V6_MINI 或 V6_WILD。 - **`V6_WILD`**：突破风格边界，带来更大胆、更独特的音乐表达。 - **`V6_MINI`**：轻量快速，兼顾音质与效率，灵感创作更简单。 - **`V6`**：更强的音乐表现力，更自然的人声与丰富细节

可选值："V6", "V6_MINI", "V6_WILD"

从生成的音频中排除的音乐风格或特征。可选。用于避免特定风格。

人声性别偏好。可选。'm' 表示男声，'f' 表示女声。注意：此参数仅在custom_mode为true时生效。根据实践，此参数只能加强概率，但不能保证一定遵循男女声的指令。

可选值："m", "f"

仅当启用自定义模式（`custom_mode: true`）时可用。对指定风格的遵循强度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

仅当启用自定义模式（`custom_mode: true`）时可用。控制实验性/创意偏离程度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

仅当启用自定义模式（`custom_mode: true`）时可用。音频要素相对权重。可选。范围 0–1，保留两位小数。 -无人声时不支持 `audio_weight`

minimum: 0

maximum: 1

用于应用于生成音乐的 Persona ID 或 Voice ID。可选。使用此选项可将特定的 Persona 风格应用于您的音乐生成。 要生成 Persona ID，请使用 [生成 Persona]([see VezAPI documentation]) 端点，基于生成的音乐创建个性化的音乐 Persona。 要生成 Voice ID，请使用 [生成 Voice]([see VezAPI documentation]) 端点。

可选值："style_persona", "voice_persona"

minimum: 10

maximum: 360

图片参考。仅在 `custom_mode=false` 时生效。 - 可选 - 最多上传 5 张图片；单张图片大小不超过 10 MB - 支持 `jpeg`、`png`、`webp` 和 `bmp` 格式

maxItems: 5

仅当启用自定义模式（`custom_mode: true`）时可用。控制生成结果的多样性和风格差异程度。可选。范围 0–4，取整数，默认值为 1。 - **`0`**：off (exact style)，完全关闭,严格用同一风格 - **`1`**：normal（balanced variety），默认值，在稳定性和多样性之间保持平衡 - **`2`**：high（distinct styles），生成风格差异明显的结果 - **`3`**：extra（bold exploration），提供更高程度的变化，鼓励大胆探索不同风格 - **`4`**：max（unreasonably varied），最大程度增加多样性，生成结果可能具有非常明显的风格差异

默认：1

minimum: 0

maximum: 4

描述音频所需的歌词内容。可选。 - V6：最多 5000 字符。 - `custom_mode=true` 时优先使用 `lyrics` 作为歌词；未传入 `lyrics` 时使用 `prompt` 作为歌词。 - `custom_mode=false` 时，`lyrics` 作为歌词附件，可与 `prompt` 中的音频描述同时使用。

音频参考。仅在 `custom_mode=false` 时生效。 - 可选 - 音频时长需在 6 秒至 30 分钟之间，单个音频文件大小不超过 500 MB

视频参考。仅在 custom_mode=false 时生效。 - 可选 - 最多上传 1 个视频文件；单个文件大小不超过 100 MB，时长不超过 241 秒且无最短时长限制 - 支持 mp4、mov 和 webm 格式

maxItems: 1

MIDI 参考。仅在 `custom_mode=false` 时生效。 - 可选 - 当前最多 1 个 MIDI 文件，不支持一次传入多个 - 支持 `mid`、`midi` 格式 - 单个文件大小不超过 256 KB，且须以标准 `MThd\x00\x00\x00\x06` 文件头开头 - 仅 `V6_WILD` 支持；传入其他 model 时会切换为 `V6_WILD`

maxItems: 1

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，用 GET /api/v1/jobs/recordInfo?taskId=... 轮询（见[“获取任务详情”](/cn/market/common/get-task-detail)）。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

原始音乐生成任务的唯一标识，由 ai-music-api/generate 或 ai-music-api/extend 生成。

要创建 Persona 的音频曲目的唯一标识符。此ID在音乐生成完成后的回调数据中返回。

Persona 的名称。一个能够捕捉音乐风格或角色本质的描述性名称。

Persona 的音乐特征、风格和个性的详细描述。请具体说明流派、情绪、乐器使用和人声特质。

用于提取人格分析片段的起始时间（以秒为单位）。用于指定音频中从哪个时间点开始提取用于人格分析的片段。该时间必须小于 vocal_end，且 vocal_end 减 vocal_start 的值必须在 10 到 30 秒之间。默认值为 0.0。

默认：0

minimum: 0

用于提取角色分析片段的结束时间（以秒为单位）。与 vocal_start 一起，用于指定分析的时间范围。vocal_end 至 vocal_start 的时间差必须在 10 到 30 秒之间，默认值为 30.0。

默认：30

minimum: 0

可选。用于补充与角色对应的音乐风格标签的说明，例如“电子流行”、“爵士三重奏”等。

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

声音描述（最多 500 字符）。

必填。请使用 V6、V6_MINI 或 V6_WILD。 - **`V6_WILD`**：突破风格边界，带来更大胆、更独特的音乐表达。 - **`V6_MINI`**：轻量快速，兼顾音质与效率，灵感创作更简单。 - **`V6`**：更强的音乐表现力，更自然的人声与丰富细节

可选值："V6", "V6_WILD", "V6_MINI"

是否循环

默认：false

不传就是Auto

默认：null

minimum: 1

maximum: 300

调性，默认 "Any"（自动）。

可选值："Any", "Cm", "C#m", "Dm", "D#m", "Em", "Fm", "F#m", "Gm", "G#m", "Am", "A#m", "Bm", "C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"

默认："Any"

是否抓取歌词字幕 完成后是否调用接口获取歌词字幕

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，用 GET /api/v1/jobs/recordInfo?taskId=... 轮询（见[“获取任务详情”](/cn/market/common/get-task-detail)）。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

音乐生成任务的唯一标识符。应为"生成音乐"或"延长音乐"接口返回的task_id。

要获取歌词的特定音频曲目的唯一标识符。此ID在音乐生成完成后的回调数据中返回。

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，用 GET /api/v1/suno/recovery/record-info?task_id={task_id} 轮询（恢复任务使用该专用轮询接口）。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

原音乐任务ID，应为音乐生成接口返回的task_id。

用于生成任务的模型名称。该字段为必填项。此接口必须使用 `ai-music-api/replace-section` 模型。

可选值："ai-music-api/replace-section"

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，用 GET /api/v1/jobs/recordInfo?taskId=... 轮询（见[“获取任务详情”](/cn/market/common/get-task-detail)）。Suno 音频类任务的结果在 data.response.data[]（audio_url、stream_audio_url、image_url、id、duration）。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

音乐片段替换任务的输入参数。

替换后的歌词。必填。

音乐的风格标签，如爵士、电子等。必填。

音乐的标题。必填。

排除的音乐风格，用于避免特定风格元素出现在替换片段中

开始替换的时间点（秒），保留2位小数。必填。必须小于 infill_end_s，且 infill_end_s 与 infill_start_s 的时间差必须至少为10 秒。

minimum: 0

结束替换的时间点（秒），保留2位小数。必填。必须大于 infill_start_s，且 infill_end_s 与 infill_start_s 的时间差必须至少为10 秒。

minimum: 0

修改后的完整歌词，包含修改和未修改歌词的合并。必填。此参数包含在分区替换后整首歌曲将使用的完整歌词文本。

替换片段的歌词。可选。 - V6、V6_MINI 和 V6_WILD：最多 5000 字符。

maxLength: 5000

人声性别偏好。可选。'm' 表示男声，'f' 表示女声。根据实践，此参数只能加强概率，但不能保证一定遵循男女声的指令。

可选值："m", "f"

对指定风格的遵循强度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

控制实验性/创意偏离程度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

音频要素相对权重。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

控制生成结果的多样性和风格差异程度。可选。范围 0–4，取整数，默认值为 1。 - **`0`**：off（关），完全关闭，严格用同一风格 - **`1`**：normal（普通），默认值，在稳定性和多样性之间保持平衡 - **`2`**：high（高），生成风格差异明显的结果 - **`3`**：extra（额外），提供更高程度的变化，鼓励大胆探索不同风格 - **`4`**：max（最大），最大程度增加多样性，生成结果可能具有非常明显的风格差异

默认：1

minimum: 0

maximum: 4

用于应用于生成音乐的 Persona ID 或 Voice ID。可选。使用此选项可将特定的 Persona 风格应用于您的音乐生成。 要生成 Persona ID，请使用 [生成 Persona]([see VezAPI documentation]) 端点，基于生成的音乐创建个性化的音乐 Persona。 要生成 Voice ID，请使用 [生成 Voice]([see VezAPI documentation]) 端点。

可选值："style_persona", "voice_persona"

默认："style_persona"

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数。task_id + audio_id 与单独的 audio_url 二选一。

分离类型，可选值： - **separate_vocal**: 分离人声和伴奏，生成人声轨道和伴奏轨道 - **split_stem**: 分离各种乐器声音，生成多个乐器轨道 - **split_stem_advanced**:高级多音轨分离，支持指定特定乐器音轨，生成更精细的乐器轨道

可选值："separate_vocal", "split_stem", "split_stem_advanced"

默认："separate_vocal"

仅在 type 为 split_stem_advanced 时使用，用于指定要分离的特定音轨/乐器名称

可选值："Lead Vocal", "Drum Kit", "Kick", "Snare", "Risers", "Bass", "Backing Vocals", "Piano", "Electric Guitar", "Percussion", "String Section", "Synth", "Acoustic Guitar", "Sound Effects", "Synth Pad", "Synth Bass", "Guitar", "Brass Section", "Organ", "Electronic Drum Kit", "Lead Electric Guitar", "Synth Keys", "Rhythm Electric Guitar", "Electric Piano", "Upright Bass", "Keyboards", "Distorted Electric Guitar", "Synth Strings", "Synth Lead", "Woodwinds", "Rhythm Acoustic Guitar", "Flute", "Harp", "Tambourine", "Trumpet", "Arpeggiator", "Accordion", "Fiddle", "Pedal Steel Guitar", "Synth Voice", "Violin", "Digital Piano", "Synth Brass", "Mandolin", "Choir", "Banjo", "Bells", "Clarinet", "Tenor Saxophone", "Trombone", "Shaker", "French Horn", "Glockenspiel", "Electric Bass", "Cello", "Timpani", "Harmonica", "Marimba", "Vibraphone", "Lap Steel Guitar", "Saxophone", "Orchestra", "Horns", "Cymbals", "Hand Clap", "Oboe", "Celesta", "Congas", "Drone", "Alto Saxophone", "Double Bass", "Ukulele", "Harpsichord", "Baritone Saxophone", "Xylophone", "Tuba", "Bass Guitar", "Whistle", "Lead Guitar", "Rhodes", "808", "Bongos", "Bassoon", "Cowbell", "Viola", "Sitar", "Steel Drums", "Piccolo", "Theremin", "Bagpipes", "Hi-Hat", "Music Box", "Melodica", "Tabla", "Koto", "Djembe", "Taiko", "Didgeridoo"

模型名称

生成任务的输入参数

“生成验证短句”接口（第 1 步）返回的 taskId，即“自建音色生成”任务结果中的 resultJson.resultUrls[0]。

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

任务task_id

用户录制服务端返回的 `validateInfo` 验证短句后的音频 URL。为了获得更好的效果，请上传或录制一段清唱人声样本。纯净的清唱人声通常能生成最准确的人声分析结果。

音色名称

音色描述

音色风格

歌手技能等级 支持：beginner、intermediate、advanced、professional

可选值："beginner", "intermediate", "advanced", "professional"

默认："beginner"

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

任务id

模型名称

默认："ai-music-api/validation-phrase"

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

用户上传的原始录音URL[必填]

截取人声开始秒数[必填]

截取人声结束秒数，必须大于vocal_start_s[必填]

验证短句语言,支持的语言有: en英文，zh中文，es西班牙语，fr法语，pt葡萄牙语言，de德语，ja日语，ko韩语，hi印地语，ru俄语

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，用 GET /api/v1/jobs/recordInfo?taskId=... 轮询（见[“获取任务详情”](/cn/market/common/get-task-detail)）。Suno 音频类任务的结果在 data.response.data[]（audio_url、stream_audio_url、image_url、id、duration）。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

用于上传源音频文件的 URL；未传 `task_id` 与 `audio_id` 时必填。有源音频（`upload_url`）即可生成。请确保上传的音频长度不超过 8 分钟。

翻唱音频的歌词。可选。 - 仅在未传入 `lyrics` 时作为歌词使用。若已传入 `lyrics`，则不再将 `prompt` 当作歌词。 - V6、V6_MINI 和 V6_WILD：最多 5000 字符。 - 非必填。有源音频（`upload_url`）即可生成。 - 若 `instrumental` 为 `true`，请勿传入此参数。

maxLength: 5000

音乐风格或流派。可选。 - 非必填。有源音频（`upload_url`）即可生成。 - 不同模型的字符限制： - **V6、V6_MINI 和 V6_WILD**：最大1000字符

maxLength: 1000

生成音乐的标题。可选。 - 最多 80 字符。 - 将显示在播放器界面和文件名中。

maxLength: 80

决定音频是否为纯音乐（无歌词）。 - 如果为 `true`：生成纯音乐（无歌词），请勿传入 `lyrics`、`prompt` 或 `vocal_gender`。 - 如果为 `false`：使用 `lyrics` 作为歌词（未传则回退到 `prompt`）。

必填。请使用 V6、V6_MINI 或 V6_WILD。 - **`V6_WILD`**：突破风格边界，带来更大胆、更独特的音乐表达。 - **`V6_MINI`**：轻量快速，兼顾音质与效率，灵感创作更简单。 - **`V6`**：更强的音乐表现力，更自然的人声与丰富细节

可选值："V6", "V6_WILD", "V6_MINI"

需要在生成的音频中排除的音乐风格或特征。 - 可选。用于避免特定风格。 示例："重金属, 强节奏鼓点"

人声性别偏好。可选。'm' 表示男声，'f' 表示女声。根据实践，此参数只能加强概率，但不能保证一定遵循男女声的指令。若 `instrumental` 为 `true`，请勿传入此参数。

可选值："m", "f"

对指定风格的遵循强度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

控制实验性/创意偏离程度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

音频要素相对权重。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

用于应用于生成音乐的 Persona ID 或 Voice ID。可选。使用此选项可将特定的 Persona 风格应用于您的音乐生成。 要生成 Persona ID，请使用 [生成 Persona]([see VezAPI documentation]) 端点，基于生成的音乐创建个性化的音乐 Persona。 要生成 Voice ID，请使用 [生成 Voice]([see VezAPI documentation]) 端点。

persona 模型：style_persona 或 voice_persona，适用于 V6、V6_MINI、V6_WILD。

可选值："voice_persona", "style_persona"

minimum: 10

maximum: 360

翻唱音频的歌词。可选。 - 优先于 `prompt` 作为歌词。未传入时，若提供了 `prompt` 则使用 `prompt` 作为歌词。 - V6、V6_MINI 和 V6_WILD：最多 5000 字符。 - 非必填。有源音频（`upload_url`）即可生成。 - 若 `instrumental` 为 `true`，请勿传入此参数。

maxLength: 5000

控制生成结果的多样性和风格差异程度。可选。范围 0–4，取整数，默认值为 1。 - **`0`**：off（关），完全关闭，严格用同一风格 - **`1`**：normal（普通），默认值，在稳定性和多样性之间保持平衡 - **`2`**：high（高），生成风格差异明显的结果 - **`3`**：extra（额外），提供更高程度的变化，鼓励大胆探索不同风格 - **`4`**：max（最大），最大程度增加多样性，生成结果可能具有非常明显的风格差异

默认：1

minimum: 0

maximum: 4

要翻唱的歌曲所属生成任务的 task_id，需与 `audio_id` 同时传；与 `upload_url` 互斥。

要翻唱的具体音轨的 id（回调数据或 recordInfo 返回的每条音轨的 `id`），需与 `task_id` 同时传；与 `upload_url` 互斥。

模型名称

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，用 GET /api/v1/jobs/recordInfo?taskId=... 轮询（见[“获取任务详情”](/cn/market/common/get-task-detail)）。Suno 音频类任务的结果在 data.response.data[]（audio_url、stream_audio_url、image_url、id、duration）。 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法

生成任务的输入参数

用于上传源音频文件的 URL，必填。有源音频（`upload_url`）即可生成。请确保上传的音频长度不超过 8 分钟。

决定音频是否为纯音乐（无歌词）。可选，默认值为 `false`。 - 如果为 `true`：生成纯音乐（无歌词），请勿传入 `lyrics`、`prompt` 或 `vocal_gender`。 - 如果为 `false`：使用 `lyrics` 作为歌词（未传则回退到 `prompt`）。

默认：false

延长音频的歌词。可选。 - 仅在未传入 `lyrics` 时作为歌词使用。若已传入 `lyrics`，则不再将 `prompt` 当作歌词。 - V6、V6_MINI 和 V6_WILD：最多 5000 字符。 - 非必填。有源音频（`upload_url`）即可生成。 - 若 `instrumental` 为 `true`，请勿传入此参数。

maxLength: 5000

音乐风格，例如爵士、古典、电子等。可选。 - 非必填。有源音频（`upload_url`）即可生成。 - 不同模型的字符限制： - **V6、V6_MINI 和 V6_WILD**：最大1000字符

maxLength: 1000

音乐标题。可选。 - 最多 100 字符。 - 将显示在播放器界面和文件名中。

maxLength: 100

音频开始扩展的时间点（以秒为单位）。 - 取值范围：大于0且小于上传音频的总时长。 - 指定从原始音频的哪个时间点开始进行扩展。

必填。请使用 V6、V6_MINI 或 V6_WILD。 - **`V6_WILD`**：突破风格边界，带来更大胆、更独特的音乐表达。 - **`V6_MINI`**：轻量快速，兼顾音质与效率，灵感创作更简单。 - **`V6`**：更强的音乐表现力，更自然的人声与丰富细节

可选值："V6", "V6_WILD", "V6_MINI"

需要在生成中排除的音乐风格

人声性别偏好。可选。'm' 表示男声，'f' 表示女声。根据实践，此参数只能加强概率，但不能保证一定遵循男女声的指令。若 `instrumental` 为 `true`，请勿传入此参数。

可选值："m", "f"

对指定风格的遵循强度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

控制实验性/创意偏离程度。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

音频要素相对权重。可选。范围 0–1，保留两位小数。

minimum: 0

maximum: 1

用于应用于生成音乐的 Persona ID 或 Voice ID。可选。使用此选项可将特定的 Persona 风格应用于您的音乐生成。 要生成 Persona ID，请使用 [生成 Persona]([see VezAPI documentation]) 端点，基于生成的音乐创建个性化的音乐 Persona。 要生成 Voice ID，请使用 [生成 Voice]([see VezAPI documentation]) 端点。

可选值："voice_persona", "style_persona"

延长音频的歌词。可选。 - 优先于 `prompt` 作为歌词。未传入时，若提供了 `prompt` 则使用 `prompt` 作为歌词。 - V6、V6_MINI 和 V6_WILD：最多 5000 字符。 - 非必填。有源音频（`upload_url`）即可生成。 - 若 `instrumental` 为 `true`，请勿传入此参数。

maxLength: 5000

控制生成结果的多样性和风格差异程度。可选。范围 0–4，取整数，默认值为 1。 - **`0`**：off（关），完全关闭，严格用同一风格 - **`1`**：normal（普通），默认值，在稳定性和多样性之间保持平衡 - **`2`**：high（高），生成风格差异明显的结果 - **`3`**：extra（额外），提供更高程度的变化，鼓励大胆探索不同风格 - **`4`**：max（最大），最大程度增加多样性，生成结果可能具有非常明显的风格差异

默认：1

minimum: 0

maximum: 4

模型标识，固定为 `ai-music-api/speech`。

可选值："ai-music-api/speech"

接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 Webhook 校验指南 了解签名验证实现方法

生成任务的输入参数。Simple / Advanced 字段互斥：Simple 只传 `customMode=false` 与 `prompt`；Advanced 传 `customMode=true` 与 `script`，其余可选。

模式开关，必填。`false` 为 Simple，`true` 为 Advanced。

仅 Simple。官方 Idea prompt，一句话描述场景，文稿由模型自写。必填，去首尾空白后 1–3000 字符。

minLength: 1

maxLength: 3000

仅 Advanced。要念的原文，必填，去首尾空白后 1–5000 字符。支持多行，JSON 中换行使用 `\n`。

minLength: 1

maxLength: 5000

仅 Advanced，可选。语气、节奏、情绪、场景，也可写口音和配乐风格。去首尾空白后 0–1000 字符。

maxLength: 1000

仅 Advanced，可选。取值：`0–4` 的整数。

可选值：0, 1, 2, 3, 4

minimum: 0

maximum: 4

仅 Advanced，可选。人声性别。大小写不敏感。不要传 `female` / `male`。

可选值："f", "m"

仅 Advanced，可选。是否配背景音乐。 - `true`：On - `false`：Off