4Z API

创建视频 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"
}