模型简介

miniMax‑H3视频生成接口，支持多模态content数组输入，可传入文本、图片、视频、音频，覆盖文生视频、图生视频（首尾帧）、多模态参考生视频场景；支持切换MiniMax‑H3、MiniMax‑H3‑Max两个模型，最高输出 2K 分辨率视频。

调用流程

接口采用异步任务模式，分两步执行：

step1：调用创建任务接口，成功返回task_id

step2：调用查询任务接口查询对应task_id，直到status值为succeeded，获取生成视频url

创建任务接口详情

http调用

请求方式：POST

请求路径：https://ai.ctaigw.cn/v1/video_generation

请求头

请求参数

响应参数

查询任务接口详情

http调用

请求方式：GET

请求路径：https://ai.ctaigw.cn/v1/query/video_generation/{task_id}

Path 路径参数

请求头

响应参数

content（VideoTaskContent）

usage（VideoTaskUsage）用量字段表

H3-Context-IR

minimax-H3

请求/响应示例

创建任务示例

请求示例

curl --request POST \
  --url https://ai.ctaigw.cn/v1/video_generation \
  --header 'Authorization: Bearer ${YOUR_APP_KEY}' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "复古70年代地铁站，街头音乐家弹奏吉他，路人匆匆走过，镜头缓慢右移"
    }
  ],
  "resolution": "2K",
  "duration": 5,
  "ratio": "16:9"
}
'

正常响应

{
  "task_id": "124010985738628"
}

异常响应示例

{
    "error": {
        "type:": "Invalid_request",
        "code": "missing_parameter",
        "message": "Missing required parameters"
    }
}

查询任务请求示例

请求

curl -X GET https://ai.ctaigw.cn/v1/query/video_generation/{task_id} \
--header "Authorization: Bearer ${YOUR_APP_KEY}"

视频生成成功

{
  "task": {
    "id": "124010985738628",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1785195529,
    "updated_at": 1785195946,
    "content": {
      "url": "https://aaaa.ctyun.cn/xxx.mp4"
    },
    "resolution": "2K",
    "duration": 5,
    "usage": {
      "total_seconds": 5,
      "input_seconds": 0,
      "output_seconds": 5,
      "input_image_count": 1,
      "input_audio_seconds": 6,
      "total_tokens": 300000,
      "prompt_tokens": 20000,
      "completion_tokens": 320000
    },
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video"
  }
}

H3-Context-IR成功

{
  "task": {
    "id": "124010985738628",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1785195529,
    "updated_at": 1785195946,
    "content": {
      "prompt": "xxxxxxxxx"
    },
    "duration": 5,
    "usage": {
      "total_tokens": 9000,
      "prompt_tokens": 6000,
      "completion_tokens": 3000
    },
    "ratio": "16:9",
    "task_type": "h3_context_ir",
    "modality": "text"
  }
}