Skip to main content
POST

Muse 视频生成

muse-video 使用 application/json 提交异步视频任务。文生视频提交 model、prompt、seconds 和 size;首帧生视频再追加单个 image URL;多图参考则使用 images URL 数组,并显式传 mode: "i2v"。

方法与路径

鉴权与请求头

请求示例

示例中的图片地址为占位地址,使用时请替换为服务端可以直接访问的公网图片 URL。

Body

string
required
模型名称。固定传 muse-video。
string
required
视频生成提示词。不能为空或仅包含空白字符;首帧和多图参考时也需要填写,建议描述主体动作、镜头运动及各张图片的参考关系。
string
required
期望视频时长,单位为秒。使用正整数的字符串形式,例如 "5"。实际时长以生成结果为准。
string
required
画幅比例。支持 16:9、9:16、1:1。直接调用 API 时应显式填写合法比例。
string
首帧图片 URL。首帧生视频时必填,同时省略 mode 和 images。只接受单个字符串,使用服务端可访问的公网 HTTP(S) 图片 URL;本地文件需先上传。不要向 image 传数组,也不要直接提交本地路径或 Base64 data URI。
array<string>
参考图片 URL 数组。参考生视频时必填,至少一张,并同时传 mode: "i2v",省略 image。第一张作为起始画面,其余作为主体、场景和风格参考,不作为指定尾帧。每项使用公网 HTTP(S) URL,不接收本地路径、Base64 data URI 或 asset://。
string
参考生视频时填写 i2v,并提供 images 数组。文生视频和单张首帧生视频省略此字段。

请求构造规则

图片要求

  • 图片必须是服务端可直接访问的公网 HTTP(S) URL。本地图片先上传,再将图片地址写入请求体。
  • image 使用字符串,images 使用字符串数组;两者不要同时提交。
  • 按预期顺序排列 images,第一张决定起始画面,后续图片提供内容参考。
  • JSON 请求中使用 URL,不提交本地路径、文件附件或 Base64 data URI;images 不接受 asset://。
图片字段使用本页的 image 或 images。此接口不提供独立的清晰度、音频开关或尾帧参数。

响应示例

以下为提交成功的精简结构示例,任务 ID 和可选字段以实际响应为准。创建成功表示任务已受理,结果需要通过查询接口获取。

Response

string
任务 ID。保存完整原值,用于后续查询与代理下载。
string
兼容响应中的任务 ID 字段。优先读取 id,没有时读取 task_id。
string
任务状态。提交后通常需要继续轮询,不能仅凭创建请求成功就认为视频已生成。

错误处理建议

错误响应可能通过顶层 code、message 或 error 对象返回。记录 HTTP 状态码和完整响应;如果已取得任务 ID,应先查询原任务,避免重复创建。

相关接口