minimax-video-h3、minimax-video-h3-max。content 多模态数组传参，提交端点为 POST /v1/wand/minimax-video-v2/generation，查询端点为 GET /v1/wand/minimax-video-v2/tasks/{task_id}。文生、图生、多模态参考生三种能力共用同一提交端点，通过 content 数组中的素材类型与 role 区分。POST /v1/wand/minimax-video-v2/generation，成功返回 task_id。task_id 调用「查询任务结果」接口，直至 task.status = succeeded，从 task.content.url 获取视频地址。request_id（顶层，用于排查问题）；查询接口额外返回 tokenhub_usage（用量消耗，含 tokenhub_usage.total_tokens）。任务状态枚举：queued / running / succeeded / failed / cancelled，以实际返回为准。模型名称 | model 参数值 | 支持能力 | 视频时长（秒） | 清晰度档位 | 选型建议 |
MiniMax-Video-H3 | minimax-video-h3 | 文生 / 图生（首尾帧）/ 多模态参考生 | 4 ~ 15 | 768P / 2K（传入 1080P 降级为 768P，4K 降级为 2K） | 旗舰款：2K 直出、多模态参考（图/视频/音频）、原生立体声。 |
MiniMax-Video-H3-Max | minimax-video-h3-max | 文生 / 图生（首帧 / 尾帧），不支持中间帧 | 5 ~ 15（不支持 4 秒） | 480P / 768P（不支持 2K；传入 1080P / 2K / 4K 会静默降级为 768P） | H3 极速版：出片更快、成本更低；不支持中间帧与多模态参考生视频。 |
ratio（画幅）取值规则：文生视频必填且不能为 adaptive；图生视频由输入图片决定（恒 adaptive）；多模态参考生视频可选。POST https://tokenhub-intl.tencentcloudmaas.com/v1/wand/minimax-video-v2/generation参数名 | 必选 | 类型 | 描述 |
model | 是 | string | 模型名称。取值： minimax-video-h3、minimax-video-h3-max |
content | 是 | array[object] | 多模态输入数组，文生视频仅含一个 text 元素。子字段：type（text）、text（提示词）。 |
resolution | 是 | string | 视频分辨率。h3：768P / 2K（传入 1080P 降级为 768P，4K 降级为 2K）；h3-max：仅 480P / 768P，不支持 2K（传入 1080P / 2K / 4K 会静默降级为 768P）。 |
duration | 是 | integer | 视频时长（秒）。h3：4 ~ 15 的整数；h3-max：5 ~ 15 的整数（不支持 4 秒）。 |
ratio | 是 | string | 画面宽高比。文生视频必填且不能为 adaptive（传 adaptive 会按 16:9 处理）。可选：21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16。 |
aigc_watermark | 否 | boolean | 是否添加 AIGC 标识水印。默认值：false。 |
curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/minimax-video-v2/generation' \\-H 'Authorization: Bearer YOUR_API_KEY' \\-H 'Content-Type: application/json' \\-d '{"model": "minimax-video-h3","content": [{"type": "text","text": "一只橙色小猫在窗台上看向镜头"}],"resolution": "2K","duration": 6,"ratio": "16:9"}'
model 替换为 minimax-video-h3-max 即可调用极速版（注意 h3-max 不支持 2K，且时长不支持 4 秒）。字段 | 类型 | 说明 |
task_id | string | 生成任务的任务 ID，用于轮询查询任务状态。 |
request_id | string | 唯一请求标识，用于排查问题。 |
base_resp，提交是否成功以 HTTP 状态码与是否返回 task_id 为准。{"task_id": "4-WandVideo-a786becfdc80433b8cff4aa344c8fd3d","request_id": "3aec3299-06ad-4654-8b45-c57b823a15d2"}
POST https://tokenhub-intl.tencentcloudmaas.com/v1/wand/minimax-video-v2/generation参数名 | 必选 | 类型 | 描述 |
model | 是 | string | 模型名称。取值： minimax-video-h3、minimax-video-h3-max |
content | 是 | array[object] | 多模态输入数组：1 个 text + 1~2 张 image_url（role 为 first_frame / last_frame；首帧 role 可不填）。图片约束：JPG / JPEG / PNG / WEBP / HEIC / HEIF；≤ 30MB；宽高 [256, 5760]px；宽高比 [0.4, 2.5]。 |
resolution | 是 | string | 视频分辨率。h3：768P / 2K（传入 1080P 降级为 768P，4K 降级为 2K）；h3-max：仅 480P / 768P，不支持 2K（传入 1080P / 2K / 4K 会静默降级为 768P）。 |
duration | 是 | integer | 视频时长（秒）。h3：4 ~ 15 的整数；h3-max：5 ~ 15 的整数（不支持 4 秒）。 |
ratio | 否 | string | 画面宽高比。图生视频默认 adaptive（由输入图片决定）；也可显式指定 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16，传入其他值不会报错但会被忽略。 |
aigc_watermark | 否 | boolean | 是否添加 AIGC 标识水印。默认值：false。 |
minimax-video-h3-max 支持首帧、尾帧，但不支持中间帧。curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/minimax-video-v2/generation' \\-H 'Authorization: Bearer YOUR_API_KEY' \\-H 'Content-Type: application/json' \\-d '{"model": "minimax-video-h3","content": [{"type": "text","text": "从首帧自然过渡到尾帧"},{"type": "image_url","image_url": { "url": "https://example.com/start.jpg" },"role": "first_frame"},{"type": "image_url","image_url": { "url": "https://example.com/end.jpg" },"role": "last_frame"}],"resolution": "768P","duration": 6}'
{"task_id": "4-WandVideo-a786becfdc80433b8cff4aa344c8fd3d","request_id": "3aec3299-06ad-4654-8b45-c57b823a15d2"}
minimax-video-h3 支持（minimax-video-h3-max 不支持多模态参考输入，content 中出现 reference_image / reference_video / reference_audio 会直接返回参数错误）。不可仅输入音频，须至少包含 1 个参考视频或图片。POST https://tokenhub-intl.tencentcloudmaas.com/v1/wand/minimax-video-v2/generation参数名 | 必选 | 类型 | 描述 |
model | 是 | string | 模型名称。取值： minimax-video-h3 |
content | 是 | array[object] | 多模态输入数组：1 个 text + 参考素材（role 为 reference_image / reference_video / reference_audio）。参考图 ≤ 9 张、参考视频 ≤ 3 段、参考音频 ≤ 3 段，素材合计 ≤ 12 个。子字段与素材约束见下表。 |
resolution | 是 | string | 视频分辨率。可选：768P / 2K。 |
duration | 是 | integer | 视频时长（秒）。可选：4 ~ 15 的整数。 |
ratio | 否 | string | 画面宽高比。默认 adaptive（自动）；可显式指定 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16。 |
aigc_watermark | 否 | boolean | 是否添加 AIGC 标识水印。默认值：false。 |
参数名 | 必选 | 类型 | 描述 |
type | 是 | string | 素材类型。枚举：text / image_url / video_url / audio_url。 |
text | 条件必选 | string | 文本提示词，type=text 时必选（每次请求必须包含一个非空 text 项）。 |
image_url | 条件必选 | object | 图片素材，type=image_url 时必选。结构 { "url": "..." } |
video_url | 条件必选 | object | 视频素材，type=video_url 时必选。结构 { "url": "..." } |
audio_url | 条件必选 | object | 音频素材，type=audio_url 时必选。结构 { "url": "..." } |
role | 否 | string | 素材用途。枚举：first_frame / last_frame / reference_image / reference_video / reference_audio。 |
reference_image / reference_video / reference_audio 任一 role，就不能再出现 first_frame / last_frame，反之亦然。curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/minimax-video-v2/generation' \\-H 'Authorization: Bearer YOUR_API_KEY' \\-H 'Content-Type: application/json' \\-d '{"model": "minimax-video-h3","content": [{"type": "text","text": "参考图中的角色在参考视频的场景中自然运动"},{"type": "image_url","image_url": { "url": "https://example.com/character.jpg" },"role": "reference_image"},{"type": "video_url","video_url": { "url": "https://example.com/scene.mp4" },"role": "reference_video"}],"resolution": "768P","duration": 6,"ratio": "16:9"}'
{"task_id": "4-WandVideo-a786becfdc80433b8cff4aa344c8fd3d","request_id": "3aec3299-06ad-4654-8b45-c57b823a15d2"}
task_id 后，通过统一的任务查询端点轮询任务状态，成功后从结果中获取视频地址。GET https://tokenhub-intl.tencentcloudmaas.com/v1/wand/minimax-video-v2/tasks/{task_id}{task_id} 即提交任务时返回的 task_id（示例中以 YOUR_TASK_ID 占位）。视频生成约需 1~3 分钟，建议每 3~5 秒轮询一次。参数名 | 必选 | 类型 | 描述 |
task_id | 是 | string | 任务 ID（路径参数），即提交任务时返回的 task_id。 |
curl -X GET 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/minimax-video-v2/tasks/YOUR_TASK_ID' \\-H 'Authorization: Bearer YOUR_API_KEY'
字段 | 类型 | 说明 |
task | object | 任务对象。 |
task.id | string | 任务 ID。 |
task.model | string | 使用的模型名称，例如 MiniMax-H3、MiniMax-H3-Max。 |
task.status | string | 任务状态：queued / running / succeeded / failed。 |
task.task_type | string | 任务类型，例如 generation（视频生成）。 |
task.created_at | integer | 任务创建时间，Unix 时间戳（秒）。 |
task.updated_at | integer | 任务更新时间，Unix 时间戳（秒）。 |
task.content | object | 任务生成结果内容，成功后返回。 |
task.content.url | string | 生成视频下载地址，临时 URL，有效期 12 小时，请及时下载保存。 |
task.duration | integer | 视频时长，单位：秒。 |
task.resolution | string | 视频分辨率，例如 768P。 |
task.ratio | string | 视频宽高比例，例如 16:9。 |
task.usage | object | 任务视频用量信息。 |
task.usage.input_image_count | integer | 输入图片数量。 |
task.usage.input_seconds | integer | 输入视频时长，单位：秒。 |
task.usage.output_seconds | integer | 输出视频时长，单位：秒。 |
task.usage.total_seconds | integer | 总计视频时长，单位：秒。 |
tokenhub_usage | object | 本次请求用量消耗。 |
tokenhub_usage.total_tokens | integer | 本次任务消耗的 token 数，用于计费和对账。 |
request_id | string | 请求唯一标识，用于问题定位和排查。 |
task 对象，无 base_resp、无顶层 status；任务标识与状态在 task.id / task.status。{"task": {"id": "4-WandVideo-a786becfdc80433b8cff4aa344c8fd3d","model": "MiniMax-H3-Max","task_type": "generation","status": "succeeded","created_at": 1772345678,"updated_at": 1772345810,"resolution": "768P","duration": 5,"ratio": "16:9","content": {"url": "https://example.com/output-video.mp4"},"usage": {"total_seconds": 5,"input_seconds": 0,"output_seconds": 5,"input_image_count": 0}},"tokenhub_usage": {"total_tokens": 102655},"request_id": "3aec3299-06ad-4654-8b45-c57b823a15d2"}
status | 含义 | 处理建议 |
succeeded | 生成成功 | 从 task.content.url 获取视频地址。 |
queued / running | 排队中 / 生成中 | 每 3~5 秒轮询一次，直至成功。 |
failed | 生成失败 | 查看失败原因（见 task.error），修改后重试；持续失败请联系技术支持并附 request_id。 |
HTTP 状态码 | 业务码 | 错误信息 | 说明 |
200 | 0 | success | 请求成功。 |
401 | 1000 | Authentication failed | Authorization 缺失或 apikey 非法。 |
401 | 1001 | Authorization is empty | 未携带 Authorization 头。 |
401 | 1002 | Authorization is invalid | apikey 无效或已失效。 |
401 | 1003 | Authorization is not yet valid | apikey 尚未生效。 |
401 | 1004 | Authorization has expired | apikey 已过期。 |
429 | 1100 | Account exception | 账号异常（可能欠费、被封禁或被暂停）。 |
429 | 1101 | Account in arrears (postpaid) | 后付费账号欠费。 |
429 | 1102 | Resource pack depleted or expired | 资源包已用完或已过期。 |
403 | 1103 | Access denied for the requested resource | 请求资源无访问权限（未订阅对应模型/能力）。 |
400 | 1200 | Invalid request parameters | 请求参数非法（缺失必选项、类型错误、枚举越界等）。 |
400 | 1201 | Invalid parameters | 参数值不合法，请对照文档参数取值范围检查。 |
404 | 1202 | The requested method is invalid | HTTP 方法错误。 |
404 | 1203 | The requested resource does not exist | 端点路径错误或资源不存在。 |
400 | 1300 | Trigger the platform strategy | 触发平台策略（如内容审核不通过、违规输入）。 |
400 | 1301 | Trigger platform sensitive word list | 命中敏感词或违规提示词。 |
429 | 1302 | Too frequent API calls | 调用过于频繁，触发限流。 |
429 | 1303 | Concurrency or QPS exceeds the limit | 并发或 QPS 超过预设配额。 |
400 | 1304 | Trigger IP strategy | 触发 IP 策略拦截。 |
500 | 5000 | Internal server error | 服务器内部错误。 |
503 | 5001 | Server is temporarily unavailable | 服务暂不可用（多为忙碌或维护中）。 |
504 | 5002 | Server internal timeout | 服务内部超时。 |
minimax-video-h3。minimax-video-h3-max。文档反馈