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

使用指南

  • 此接口扩展上传的音频文件,同时保留原始风格
  • 上传已有音轨,并指定从何处继续
  • AI 会生成与原曲无缝融合的新增内容
  • 上传的音频文件时长不得超过 8 分钟(注意:V4_5ALL 模型最长 1 分钟)

参数详情

  • default_param_flag: true(自定义参数模式)时:
    • 可完全控制风格、标题等参数
    • 若 instrumental: true:只需 style、title 和 upload_url
    • 若 instrumental: false:需要 style、title、prompt(作为准确歌词)和 upload_url
    • 字符上限因模型而异:
      • 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 个字符
  • default_param_flag: false 时:
    • 只需 upload_url。若 instrumental: false,会自动生成歌词

使用说明

  • 建议:需要快速扩展并保持原始风格时,使用 default_param_flag: false
  • continue_at 参数决定扩展从何处开始,请设为希望新内容开始的时间点

可选参数

  • prompt (string):扩展音频的描述或歌词。default_param_flag 为 true 且 instrumental 为 false 时必填。prompt 会严格作为歌词。default_param_flag 为 false 时,会根据 prompt 自动生成歌词。
  • style (string):音乐风格说明。default_param_flag 为 true 时必填。
  • title (string):扩展音频的曲目标题。字符上限因模型而异(V4:80,V4_5 & V4_5PLUS & V5:100,V4_5ALL:80)。
  • 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-extend-audio"

input
object
必填

音频扩展的输入参数

callback_url
string<uri>

接收结果通知的 Webhook 回调 URL

示例:

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

响应

200 - application/json

任务提交成功

code
integer
必填

HTTP 状态码

示例:

200

data
object
必填