03-创建H3-Context-IR任务
创建 H3-Context-IR 任务
文档版本：v1.0.0 | 最后更新：2026-08-13 本平台已完整适配 MiniMax 视频生成 V2（MiniMax-H3）官方接口，请求与响应均为透传，参数语义与官方一致。
注意：本接口只返回增强后的视频提示词，不会创建视频生成任务。
task_id，任务的 task_type 为 h3_context_ir、modality 为 text；任务成功后，从查询任务响应的 content.prompt 获取增强提示词。增强提示词可直接用于创建视频生成任务，也是按源视频再生成时要求回传的"最终 prompt"。POST https://platform.shuyanai.com/hailuo/v2/h3_context_ir请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string (enum) | 是 | — | 模型名称。当前可用值：MiniMax-H3 |
content | array | 是 | — | 多模态上下文输入数组，必须包含一个非空 text 项。组合规则、元素结构与媒体限制同创建视频生成任务 |
duration | integer | 是 | — | 目标视频时长（秒），整数。可用值：4~15 |
ratio | string (enum) | 条件 | adaptive | 目标视频宽高比，取值规则同创建视频生成任务 |
callback_url | string | 否 | — | 任务状态变更回调地址，行为同创建视频生成任务 |
本接口无 resolution参数。
请求示例
响应示例
{
"task_id": "426586401755526"
}{
"task": {
"id": "426586401755526",
"model": "MiniMax-H3",
"status": "succeeded",
"content": {
"prompt": "integrated_multimodal_description: [Shot 1] Cinematic, wide shot with a slow push in on a female captain ..."
},
"duration": 5,
"usage": {
"total_tokens": 9090,
"prompt_tokens": 5664,
"completion_tokens": 3426
},
"ratio": "16:9",
"task_type": "h3_context_ir",
"modality": "text"
}
}计费说明
usage.prompt_tokens（输入）与 usage.completion_tokens（输出）分别结算，提交时不预扣，失败不计费。详见概述 · 计费与结算。