创建 H3-Context-IR 任务

文档版本：v1.0.0 | 最后更新：2026-08-13
本平台已完整适配 MiniMax 视频生成 V2（MiniMax-H3）官方接口，请求与响应均为透传，参数语义与官方一致。

H3-Context-IR 对文本、图像、音频和视频等多模态上下文进行深度理解，分析素材之间以及素材与目标生成结果之间的关系，并进行复杂逻辑推理，将理解结果转换为结构化表达，在尽量保持用户原始意图的前提下丰富语义细节。

注意：本接口只返回增强后的视频提示词，不会创建视频生成任务。

本接口为异步接口，创建成功后返回 task_id，任务的 task_type 为 h3_context_ir、modality 为 text；任务成功后，从查询任务响应的 content.prompt 获取增强提示词。增强提示词可直接用于创建视频生成任务，也是按源视频再生成时要求回传的"最终 prompt"。

POST https://studio.dataeyes.ai/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"
  }
}

计费说明

按 token 计费：任务成功后按 usage.prompt_tokens（输入）与 usage.completion_tokens（输出）分别结算，提交时不预扣，失败不计费。详见概述 · 计费与结算。

03-创建H3-Context-IR任务

创建 H3-Context-IR 任务#

请求参数#

请求示例#

响应示例#

计费说明#

创建 H3-Context-IR 任务

请求参数

请求示例

响应示例

计费说明