跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询音乐详情接口获取结果。

使用指南

  • 此接口将上传的音轨转换为新风格,同时保留原始旋律
  • 上传音频文件并指定期望的转换风格
  • 在应用新音乐特征的同时,保留原始旋律和结构

参数详情

  • 音频上传要求:
    • 上传的音频时长不得超过 8 分钟
    • 注意:使用 V4_5ALL 模型时,上传的音频时长不得超过 1 分钟
    • 通过 upload_url 提供指向音频文件的有效 URL
  • 自定义模式(custom_mode: true):
    • style 和 title 为必填
    • instrumental 为 false 时,prompt 为必填
    • 字符上限因模型而异:
      • V4:prompt 3000 个字符,style 200 个字符,title 80 个字符
      • V4_5 & V4_5PLUS:prompt 5000 个字符,style 1000 个字符,title 100 个字符
      • V4_5ALL:prompt 5000 个字符,style 1000 个字符,title 80 个字符
      • V5:prompt 5000 个字符,style 1000 个字符,title 100 个字符
  • 非自定义模式(custom_mode: false):
    • prompt 为必填,用于描述期望的转换(最多 500 个字符)
    • style 和 title 应留空

使用说明

  • 确保音频 URL 可公开访问,且文件时长不超过 8 分钟(V4_5ALL 为 1 分钟)
  • 为获得最佳效果,请使用旋律线清晰的高质量源音频
  • audio_weight 参数有助于在保留原曲与应用新风格之间取得平衡

可选参数

  • negative_tags (string):翻唱时要排除的音乐风格或特征。
  • vocal_gender (string):人声性别偏好。m 为男声,f 为女声。注意:此参数只能提高概率,无法保证严格遵循。
  • style_weight (number):遵循新风格的强度。取值 0-1,最多 2 位小数。
  • weirdness_constraint (number):控制创意偏离程度。取值 0-1,最多 2 位小数。
  • audio_weight (number):保留原始音频特征的平衡权重。取值 0-1,最多 2 位小数。
  • persona_id (string):应用于翻唱曲目的 Persona ID。如何生成 persona_id,请参阅 generate-persona。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证

获取 API Key:

进入 仪表盘 → API 密钥(API Key 管理页面)获取你的 API Key

在请求头中添加:

请求体

application/json
model
string
必填
示例:

"upload-and-cover-audio"

input
object
必填

音频翻唱生成的输入参数

callback_url
string<uri>

用于接收结果通知的 Webhook 回调 URL。

接收任务完成更新的接口。

示例:

"https://your-domain.com/callback"

响应

200 - application/json

任务提交成功

code
integer
必填

HTTP 状态码

示例:

200

data
object
必填