创建视频 muse-video
接口: POST https://4zapi.com/v1/videos
文生视频 / 图生视频(首帧),输出带声音的 720P MP4。异步任务:提交后用「查询视频 muse-video」轮询,completed 后用「下载视频 muse-video」下载。
| 参数 | 必填 | 说明 |
|---|---|---|
| model | 是 | 固定 muse-video |
| prompt | 是 | 画面描述,中英文均可,最多 4000 字 |
| seconds | 否 | 4–30 的整数(字符串或数字),默认 4;按此秒数计费。字段名是 seconds,不是 duration |
| size | 否 | 1280x720(横屏)或 720x1280(竖屏),不填为横屏 |
| input_reference | 否 | 首帧图(图生视频):图片 URL 或 data URL,支持 PNG/JPEG/WebP,不支持文件 ID;也可用 multipart/form-data 直接上传文件 |
| resolution | 否 | 只能为 720p,可不传 |
- 计费:按请求秒数计费,提交时预扣;任务失败自动退款;参数不合法返回 400(code 为
client_local_validation),不建任务不扣费。 - 实际时长向上取档,不会比请求的短:4、5→5 秒;6→6;7、8→8;9、10→10;11–15→15;16–20→20;21–25→25;26–30→30。
- 超过 10 秒分段生成后拼接,在第 10、20 秒处换镜头。
- 耗时:10 秒以内约 1–2 分钟,15–30 秒约 3–7 分钟;建议每 10–20 秒查询一次。
参数
Content-Type(header, string, 必填)
请求体 (application/json)
model(string, 必填)prompt(string, 必填)seconds(string, 必填)size(string, 必填)
请求示例
{
"model": "muse-video",
"prompt": "金色的枫叶在微风中飘落,阳光穿过树梢,电影感",
"seconds": "5",
"size": "1280x720"
}