4Z API

提交视频生成任务

接口: POST https://4zapi.com/minimax/v1/video_generation

文生视频或图生视频。提交后返回 task_id,通过 GET /minimax/v1/query/video_generation 轮询结果。

请求体 (application/json)

  • model (string, 必填): 模型名称 ["MiniMax-H3", "MiniMax-Hailuo-2.3-Fast", "T2V-01-Director", "I2V-01-Director", "S2V-01"]
  • prompt (string, 必填): 视频内容描述提示词
  • aigc_watermark (boolean): 是否添加 AIGC 水印
  • callback_url (string): 任务完成回调 URL
  • duration (integer): 视频时长(秒) [6, 10]
  • fast_pretreatment (boolean): 是否缩短优化耗时(仅 2.3/02 模型)
  • first_frame_image (string): 首帧图片 URL 或 Base64(图生视频);`MiniMax-Hailuo-2.3-Fast` 必填
  • last_frame_image (string): 尾帧图片 URL 或 Base64(首尾帧生视频)
  • prompt_optimizer (boolean): 是否自动优化 prompt
  • resolution (string): 分辨率(大写 P) ["512P", "768P", "1080P"]
  • subject_reference (array<object>): 主体参考(S2V-01 模型)

请求示例

{
  "aigc_watermark": false,
  "callback_url": "https://your-domain.com/api/video/callback",
  "duration": 6,
  "first_frame_image": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg",
  "last_frame_image": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg",
  "model": "MiniMax-H3",
  "prompt": "A little girl grow up [推进].",
  "prompt_optimizer": true,
  "resolution": "1080P"
}