Lyria 3.5 Cover 改编

  • 用 Lyria 3.5 做 Cover 改编，异步任务
  • 与普通 Cover 共用端点，靠 version 区分
  • 产出新的 clip_id
POST/v1/music/generations/coverFlowMusic

认证

string必填

所有接口均使用 Bearer Token 进行认证。

获取 API Key：访问控制台 创建。

请求时在请求头中添加：

Authorization: Bearer YOUR_OAIRoute_KEY

请求参数

string必填

固定传 flowmusic，大小写不敏感。

不要写成 lyria-3.5 或 flowmusic-lyria-3.5——模型名只有一个，版本走 version 字段。

string必填

固定传 lyria-3.5。这是本接口与普通 Cover 的唯一区别。

string必填

源音乐唯一标识，取自已成功任务的 result.music[].clip_id。

string必填

Cover 编辑指令，例如「将这首歌曲改为爵士风格」。

number必填

编辑强度，取值 0 到 1。越大改动越大。

string可选

Cover 后的音乐标题。

string可选

随机种子，用于结果复现。

最容易踩的一个坑

model 与 version 是两个字段，职责不同：

字段传什么传错的后果
modelflowmusic写成 lyria-3.5 会找不到模型
versionlyria-3.5不传就走普通模型，不报错但结果不同

第二行是隐性的：漏传 version 不会报错，只是走的不是 Lyria。产出结果对不对，只有对比才知道。

提交响应

integer

状态码，成功为 200。

data[] 的元素字段 · 2 项
string

任务状态，提交时为 submitted。

string

任务唯一标识，用于查询状态与结果。

查询结果

用 GET /v1/music/tasks/{task_id} 查询。

data 的元素字段 · 8 项
string

任务 ID。

string

如 completed。

integer

进度百分比。

integer

创建时间，Unix 时间戳。

integer

完成时间，Unix 时间戳。

integer

耗时，单位秒。

number

费用。

number

积分消耗。

result.music[] 的元素字段 · 6 项
string

Cover 产物对应的新 clip_id。后续操作请使用新值。

string

标题。

string

时长，字符串形式。

string

音频地址，m4a。

string

WAV 格式地址。

string

封面图地址。

错误

HTTPcode说明
400invalid_requeststrength 越界，如 strength must be between 0 and 1
429rate_limit_error当前分组容量饱和，请稍后重试

更多状态码与重试建议见错误码与限流，常见报错的排查步骤见常见问题。

使用示例

提交一个任务并拿到 task_id：

提交成功只表示任务已受理。真正的产物要拿返回的 task_id 去任务查询接口轮询，status 变成 completed 之后才有结果。