创建 MiniMax H3 Context-IR 任务

Context-IR 是 minimax-h3 的提示词增强能力。它会理解多模态素材之间的关系，并返回更完整、结构化的视频提示词，不会直接生成视频。

POST /v1/videos/context-ir

本接口为异步接口。创建成功后保存平台任务 id，然后调用查询 Context-IR 任务获取增强后的提示词。

请求示例

curl --request POST \
  --url "https://{your-domain}/v1/videos/context-ir" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "minimax-h3",
    "content": [
      {
        "type": "text",
        "text": "史诗级太空歌剧院线预告：女舰长站在巨大观景窗前，最后一支舰队跃迁离去。"
      }
    ],
    "duration": 5,
    "ratio": "16:9"
  }'

curl --request POST \
  --url "https://{your-domain}/v1/videos/context-ir" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "minimax-h3",
    "content": [
      {
        "type": "text",
        "text": "镜头缓慢推进，人物抬头看向寺庙穹顶，烛火轻微摇曳。"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/first-frame.png"
        },
        "role": "first_frame"
      }
    ],
    "duration": 6,
    "ratio": "adaptive"
  }'

curl --request POST \
  --url "https://{your-domain}/v1/videos/context-ir" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "minimax-h3",
    "content": [
      {
        "type": "text",
        "text": "参考人物外观、镜头运动和音色，生成电影感追逐镜头。"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/reference.png"
        },
        "role": "reference_image"
      },
      {
        "type": "video_url",
        "video_url": {
          "url": "https://example.com/reference.mp4"
        },
        "role": "reference_video"
      },
      {
        "type": "audio_url",
        "audio_url": {
          "url": "https://example.com/reference.mp3"
        },
        "role": "reference_audio"
      }
    ],
    "duration": 8,
    "ratio": "adaptive"
  }'

请求参数

参数	类型	必填	说明
`model`	string	是	固定使用 `minimax-h3`，与视频生成使用同一个模型 ID。
`content`	object[]	是	多模态上下文，必须包含且只能包含一项非空 `text`。
`duration`	integer	是	目标视频时长，支持 4–15 秒。
`ratio`	string	条件必填	文本上下文必须传固定比例；图片或多模态参考可使用 `adaptive`。

content 的角色组合、数量和素材限制与创建 MiniMax H3 视频任务相同。

Context-IR 复用 H3 的音频输入规则：Base64 音频请使用 data:audio/mp3;base64,... 或 data:audio/wav;base64,...。沙箱实测 data:audio/mpeg;base64,... 会被上游识别为 .mpeg 并拒绝。

平台暂不接受 callback_url。请使用任务查询接口轮询状态，避免上游回调绕过平台任务 ID 和结算状态。

创建响应

HTTP 状态码：202 Accepted

{
  "id": "irtask_16a77bfc435343ff98cf67d17f23336e",
  "object": "video.context_ir.task",
  "created": 1786099200,
  "model": "minimax-h3",
  "status": "queued",
  "task_type": "h3_context_ir",
  "expires_at": 1786272000
}

创建时平台会按 Context-IR endpoint capability 中配置的输入、输出 Token 预冻结预算估算费用。这两个预算不是模型请求上限；任务完成后按照上游返回的真实 Token 用量结算，多余冻结金额自动退回。

失败状态

HTTP 状态码	错误类型	场景
`400`	`invalid_request_error`	参数缺失、输入组合不合法或素材不符合限制。
`401`	`authentication_error`	API Key 缺失或无效。
`402`	`insufficient_balance`	当前账户余额不足。
`403`	`model_not_visible`	模型不可见或当前 API Key 没有权限。
`429`	`quota_exceeded`	API Key 额度已用尽或请求受到限流。
`500`	`internal_error`	平台内部错误，任务未成功创建。

失败响应示例

请求参数不符合校验规则时，接口返回 HTTP 400：

{
  "error": {
    "type": "invalid_request_error",
    "message": "duration must be between 4 and 15"
  }
}

任务创建成功但上游处理失败时，请通过查询 Context-IR 任务读取任务级失败响应。创建接口本身只表示任务已进入异步队列，不代表提示词已经生成。

开始使用

API 参考

模型与计费

指南

参考

请求示例

请求参数

创建响应

失败状态

失败响应示例

相关接口

​请求示例

​请求参数

​创建响应

​失败状态

​失败响应示例

​相关接口

请求示例

请求参数

创建响应

失败状态

失败响应示例

相关接口