生成音乐视频

  • 把音频合成为带可视画面的视频文件，异步任务
  • 结果在 data.result.videoUrl
  • 与「音乐视频渲染」（Flow Music）是两个不同接口
POST/v1/music/generations/generateMp4

认证

string必填

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

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

请求时在请求头中添加：

Authorization: Bearer YOUR_OAIRoute_KEY

请求参数

string可选

音频模型，默认 suno，当前传 suno。

string必填

产出源音轨那次任务的 task_id。缺失或无法解析源时返回 400。

integer可选

引用源任务结果 data.result.music[] 中的第几首，默认 1，从 1 开始。一次生成通常 2 首。

本端点没有版本参数，不要传 version。

响应

integer

响应状态码。

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

任务状态，提交成功后为 submitted。

string

任务唯一标识，用于轮询获取结果。

取结果

轮询 GET /v1/music/tasks/{task_id}。

data.result 的元素字段
string

视频地址，完成后优先读取这个字段。

result 的元素字段
array

兼容历史返回格式。

result.music[] 的元素字段
string

兼容历史返回格式。

返回结构有三套写法。新任务读 data.result.videoUrl；老任务的数据在 result.videos[] 或 result.music[].video_url 里。接的时候按这三处依次兜底。

视频里有什么

生成的是「配了可视画面」的音乐视频，画面通常随音乐节奏变化，形态接近可视化音频或动态封面，不是叙事性的 MV。

需要叙事性内容，应该用视频生成接口自己出片，再用剪辑工具配上音频。

计费与产出

按次计费，与音频生成分开结算。产出的视频文件通常比音频大一个数量级，注意存储成本。

视频地址可能有有效期，拿到后尽快转存。不要把它当作长期存储地址直接嵌在前端页面里。

错误码

错误响应的格式、状态码与重试建议见错误码与限流，常见报错的排查步骤见常见问题。

使用示例

提交一个任务并拿到 task_id：

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