Skip to main content
POST
POST https://code.heihuzi.ai/v2/video_generation 创建一个视频生成任务,请求和返回的字段与 MiniMax 的视频生成接口相同。任务异步执行:创建后返回 task_id,再用查询任务获取成片链接。 请使用绑定「MiniMax 视频」分组的 API Key。
运行前设置环境变量 HEIHUZI_API_KEY。

请求参数

string
required
MiniMax-H3-Max 或 MiniMax-H3。
object[]
required
输入内容数组。必须包含且只包含一项文字,其余各项可选:
  • 文字:{"type": "text", "text": "画面与动作描述"}
  • 首帧图:{"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/first.jpg"}},填 https 图片链接或 Base64 编码,1 张。
  • 尾帧图:{"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/last.jpg"}},填 https 图片链接或 Base64 编码,1 张。MiniMax-H3 可以只给尾帧;MiniMax-H3-Max 给尾帧时必须同时给首帧。
  • 参考图:{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/reference.jpg"}},填 https 图片链接或 Base64 编码,最多 9 张。
  • 参考视频:{"type": "video_url", "role": "reference_video", "video_url": {"url": "https://example.com/reference.mp4"}},填 https 视频链接,最多 3 个,合计不超过 15 秒。
首帧图、尾帧图不能和参考图、参考视频同时使用;参考图和参考视频可以一起用。图片和视频的格式、大小等要求见下方「输入素材要求」。
string
required
清晰度。MiniMax-H3-Max:480P、768P;MiniMax-H3:768P、2K。
integer
required
时长(秒)。MiniMax-H3-Max:5–15;MiniMax-H3:4–15。
string
画面比例:21:9、16:9、4:3、1:1、3:4、9:16。只有文字时必须填写;带首帧图或尾帧图时由图片决定比例,不需要填写;带参考图或参考视频时可以不填,由模型自动选择。
object
额外生成选项,仅 MiniMax-H3-Max。支持 {"prompt_expansion_mode": "balanced"}(提示词均衡扩写,不传时也按此处理)。
boolean
传 true 时在视频右下角加“AI生成”标识;不传则不加。

输入素材要求

请求体不超过 64 MB,大文件请用链接,不要用 Base64 编码。 图片(首帧图、尾帧图、参考图): 参考视频:

示例

首帧图

把本机图片转换为 Base64 字符串,写成 data:image/jpeg;base64,<Base64 编码> 填入 image_url.url。不要填本机文件路径(如 /Users/...、file://...)。

参考图

在文字里说明参考图里的内容怎么用。

参考视频

在文字里说明参考视频怎么用。

响应

task_id 是任务号,用它查询和删除任务。

计费

  • 按成片秒数计费,不同型号、清晰度单价不同,价格以便利店当前分组配置和用量明细为准。
  • 提交时按请求的秒数冻结余额,生成成功后扣除;生成失败或请求被拒绝时全额退回。
  • 首帧图、尾帧图不另外收费。
  • 参考图:MiniMax-H3-Max 的前 2 张、MiniMax-H3 的前 5 张不另外收费,超出的按张计费。
  • 参考视频:按参考视频的时长另外计费。提交时先按 15 秒冻结,生成成功后按实际时长扣除,多冻结的退回。

错误响应

参数不符合要求时不会冻结余额。参考视频链接的路径不以 .mp4 或 .mov 结尾时,请求会被拒绝,冻结的余额全额退回。