创建 Context-IR 提示词任务

POST /v2/h3_context_ir

异步生成视频提示词，结果是文本。请求体仍填 model=MiniMax-H3；令牌和分组需允许 MiniMax-H3-Context-IR。使用平台 Bearer 模型密钥。

请求参数

参数	类型	必选	说明
model	string	是	固定 MiniMax-H3
content	array<object>	是	至少一个非空文本项，每项最多 7,000 个字符；媒体角色和组合规则见接入指南
duration	integer	是	目标视频时长，4–15 秒
ratio	string	纯文本必填	只有文本时必须指定具体宽高比，例如 16:9；有首尾帧或参考素材时可使用 adaptive
callback_url	string	否	客户回调地址，需先通过 challenge 校验

本接口不传 resolution、source_task_id。Context-IR 不会直接生成视频；生成的提示词可由业务方读取后用于后续视频请求，后续视频生成是独立任务并单独计费。

请求示例

{
  "model": "MiniMax-H3",
  "duration": 4,
  "ratio": "16:9",
  "content": [
    {"type": "text", "text": "将以下想法展开成视频提示词：一只小猫在阳光下伸懒腰，镜头缓慢推进"}
  ]
}

响应（HTTP 200）

{"task_id":"task_platform_ir"}

保存平台 task_id 并调用查询任务。成功时 task.task_type=h3_context_ir、task.modality=text，从 task.content.prompt 读取提示词，不读取视频 URL。

{
  "task": {
    "id": "task_platform_ir",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "task_type": "h3_context_ir",
    "modality": "text",
    "content": {"prompt": "温暖的午后阳光中，一只小猫缓缓伸展身体，镜头平稳推进……"}
  }
}

本接口按输入／输出 Token 结算，价格以控制台配置为准。查询和客户回调均不返回上游 usage。