创建视频生成任务

通过多模态 content 数组创建视频生成任务。请求成功后返回任务 ID；视频生成在后台异步执行，请使用查询任务获取结果。

请求

项目	值
请求方法	`POST`
请求地址	`https://token.aiznt.com/v2/video_generation`
认证方式	`Authorization: Bearer sk-你的密钥`
Content-Type	`application/json`

curl https://token.aiznt.com/v2/video_generation \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "史诗级太空歌剧预告：女舰长站在巨大观景窗前，最后一支舰队跃迁离去。"
    }
  ],
  "resolution": "2K",
  "duration": 5,
  "ratio": "16:9",
  "aigc_watermark": false
}'

请求参数

字段	类型	必填	可选值/范围	说明
`model`	string	是	`MiniMax-H3`、`MiniMax-H3-Max`	模型名称。H3-Max 不支持多模态参考素材和 `2K`。
`content`	array	是	—	多模态输入。必须至少包含一个非空 `text` 项；单个文本最多 7000 个字符。
`resolution`	string	是	H3：`768P`/`2K`；H3-Max：`480P`/`768P`	输出分辨率。
`duration`	integer	是	H3：4–15；H3-Max：5–15	视频时长，单位为秒。
`ratio`	string	文生视频必填	`adaptive`、`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`	文生视频不能使用 `adaptive`；图生视频按输入图片比例处理；参考生视频默认 `adaptive`。
`callback_url`	string	否	URL	状态变化回调地址。首次验证请求需在 3 秒内原样返回 `challenge`。
`aigc_watermark`	boolean	否	`true`/`false`	是否添加 AIGC 标识水印，默认 `false`。

`content` 项

每个项包含 type，并按类型提供对应字段：

`type`	必需字段	`role`	用途
`text`	`text`	—	视频提示词，所有场景必需。
`image_url`	`image_url.url`	`first_frame`、`last_frame` 或 `reference_image`	首帧/尾帧图生视频，或参考图片。
`video_url`	`video_url.url`	`reference_video`	多模态参考视频，仅 H3 支持。
`audio_url`	`audio_url.url`	`reference_audio`	多模态参考音频，仅 H3 支持。

url 可以是公网 URL、mm_file://{file_id}，或符合格式的 Base64 data URI。图生视频（first_frame/last_frame）与多模态参考生视频（reference_*）不能混用。

常用请求示例

首尾帧图生视频

{
  "model": "MiniMax-H3",
  "content": [
    {"type": "text", "text": "镜头从街道推近到人物面部，人物自然地微笑。"},
    {"type": "image_url", "image_url": {"url": "https://example.com/first.png"}, "role": "first_frame"},
    {"type": "image_url", "image_url": {"url": "https://example.com/last.png"}, "role": "last_frame"}
  ],
  "resolution": "2K",
  "duration": 8,
  "ratio": "adaptive"
}

多模态参考生视频（H3）

{
  "model": "MiniMax-H3",
  "content": [
    {"type": "text", "text": "角色跟随参考视频中的动作，并使用参考音频的声音。"},
    {"type": "image_url", "image_url": {"url": "https://example.com/character.png"}, "role": "reference_image"},
    {"type": "video_url", "video_url": {"url": "https://example.com/motion.mp4"}, "role": "reference_video"},
    {"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}, "role": "reference_audio"}
  ],
  "resolution": "2K",
  "duration": 5,
  "ratio": "adaptive"
}

媒体限制

请求体总大小不超过 64 MB，建议大文件使用公网 URL 或 mm_file://，不要直接提交 Base64。

媒体	限制
图片	JPG/JPEG/PNG/WEBP/HEIC/HEIF；单文件 ≤30 MB；宽高 256–5760 px；宽高比 0.4–2.5；首帧最多 1 张、尾帧最多 1 张、参考图最多 9 张。
视频	MP4/MOV；H.264/H.265，音频 AAC/MP3；单文件 ≤50 MB；单段 2–15 秒、总时长 ≤15 秒；最多 3 个；帧率 23.976–60。仅作 H3 参考视频。
音频	WAV/MP3；单文件 ≤15 MB；单段 2–15 秒、总时长 ≤15 秒；最多 3 个。仅作 H3 参考音频。

响应

{
  "task_id": "task_01JZ3Q7M7Y7X5Y6R8K9P"
}

字段	类型	说明
`task_id`	string	AIZNT 网关生成的公开任务 ID，用于调用 `GET /v2/query/video_generation/{task_id}`。

异步任务

创建成功只表示任务已进入队列，不代表视频已经生成。请轮询查询接口，并在状态为 succeeded 后读取视频 URL。

常见错误

HTTP 状态	含义	常见原因
`400`	参数错误	缺少 `model`、`content`、`resolution` 或 `duration`；没有非空文本；时长/分辨率不符合模型限制。
`401`	鉴权失败	`Authorization` 缺失或密钥无效。
`402`	额度不足	账户余额或视频额度不足。
`422`	内容审核失败	视频描述或素材涉及敏感内容。
`429`	触发限流	请求过于频繁，请稍后重试。
`500`	服务端错误	上游或网关内部错误。

创建视频生成任务

本页目录