MiniMax-H3 API 示例

MiniMax-H3 是 MiniMax 原生视频生成模型，支持文本生视频（t2va）、图生视频（首帧/末帧）以及参考生视频（参考图/参考视频/参考音频），输出分辨率支持 768P 与 2K。本页面介绍 Agentsflare 代理的四个 MiniMax 原生接口：视频生成、视频重生成、H3-Context-IR（提示词增强）以及任务查询。

基础配置

在开始使用 API 之前，请确保您已经获取了 API Key。如果还没有，请参考创建 API Key。

接口一览

用途	请求方法与路径
创建视频生成任务	`POST https://api.agentsflare.com/minimax/v2/video_generation`
创建 H3-Context-IR 任务（提示词增强）	`POST https://api.agentsflare.com/minimax/v2/h3_context_ir`
创建视频重生成任务（768P → 2K）	`POST https://api.agentsflare.com/minimax/v2/video_regeneration`
查询任务状态与结果	`GET https://api.agentsflare.com/minimax/v2/query/video_generation/{task_id}`

认证方式：Authorization: Bearer <API_KEY>
内容类型：application/json
所有创建接口均为异步：提交后返回 task_id，需轮询查询接口，直到 status 变为 succeeded / failed / cancelled。
原厂参考文档：MiniMax Video Generation V2

请求参数（摘要）

参数	必填	说明
`model`	是	目前仅支持 `MiniMax-H3`
`content`	是	多模态输入数组，每项包含 `type`（`text`/`image_url`/`video_url`/`audio_url`）和可选的 `role`。每次请求必须包含且仅包含一个非空的 `text` 项
`resolution`	条件必填	`768P` 或 `2K`。视频生成必填；视频重生成仅支持 `2K`
`duration`	条件必填	视频时长（秒），范围 `4`–`15`。视频生成和 H3-Context-IR 必填；视频重生成不涉及
`ratio`	可选	画幅比。`adaptive`（默认）、`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`。纯文本生视频时必填且不能是 `adaptive`
`source_task_id`	条件必填	按任务ID重生成：已成功的视频生成任务的 `task_id`
`callback_url`	可选	任务状态变更回调URL

content 中 role 的取值：first_frame、last_frame、reference_image、reference_video、reference_audio、base_video（仅重生成使用）。图生视频（first_frame/last_frame）与参考生视频（reference_*）互斥，不能混用。

请求示例

1. 创建视频生成任务

cURL - 文本生视频cURL - 图生视频PythonNode.js

bash

curl -X POST "https://api.agentsflare.com/minimax/v2/video_generation" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "史诗级太空歌剧预告片：一位女舰长独自站在巨大的观察窗前，最后一批舰队在耀眼的闪光中集结跃迁离去，舰桥剧烈震动，将她独自留下。"
      }
    ],
    "resolution": "2K",
    "duration": 5,
    "ratio": "16:9"
  }'

bash

curl -X POST "https://api.agentsflare.com/minimax/v2/video_generation" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "镜头拉焦到背景中的人物，为拉面碗增加更多蒸汽。"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/first-frame.png" },
        "role": "first_frame"
      }
    ],
    "resolution": "2K",
    "duration": 5,
    "ratio": "adaptive"
  }'

python

import requests
import os

API_BASE = "https://api.agentsflare.com/minimax/v2/video_generation"
API_KEY = os.getenv("API_KEY")

payload = {
    "model": "MiniMax-H3",
    "content": [
        {"type": "text", "text": "一个男孩在海边打篮球"}
    ],
    "resolution": "2K",
    "duration": 5,
    "ratio": "16:9"
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

resp = requests.post(API_BASE, json=payload, headers=headers)
result = resp.json()
print("Task ID:", result.get("task_id"))

javascript

const API_BASE = 'https://api.agentsflare.com/minimax/v2/video_generation';
const API_KEY = process.env.API_KEY;

async function createVideo() {
  const payload = {
    model: 'MiniMax-H3',
    content: [
      { type: 'text', text: '一个男孩在海边打篮球' }
    ],
    resolution: '2K',
    duration: 5,
    ratio: '16:9'
  };

  const res = await fetch(API_BASE, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
  });

  const data = await res.json();
  console.log('Task ID:', data.task_id);
}

createVideo().catch(console.error);

响应：

json

{ "task_id": "424010985738629" }

2. 创建 H3-Context-IR 任务（提示词增强）

H3-Context-IR 不会生成视频，而是深度理解多模态上下文，返回结构化、语义更丰富的提示词（按 token 计费），可用作后续视频生成任务的输入。

cURLPython

bash

curl -X POST "https://api.agentsflare.com/minimax/v2/h3_context_ir" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      { "type": "text", "text": "一个男孩在海边打篮球" }
    ],
    "duration": 5,
    "ratio": "16:9"
  }'

python

import requests
import os

API_BASE = "https://api.agentsflare.com/minimax/v2/h3_context_ir"
API_KEY = os.getenv("API_KEY")

payload = {
    "model": "MiniMax-H3",
    "content": [
        {"type": "text", "text": "一个男孩在海边打篮球"}
    ],
    "duration": 5,
    "ratio": "16:9"
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

resp = requests.post(API_BASE, json=payload, headers=headers)
print(resp.json())

3. 创建视频重生成任务（768P → 2K）

将符合 MiniMax-H3 768P 输出规格的源视频升级为 2K。支持两种方式：按 source_task_id（已成功的生成任务，需白名单权限）或按 base_video（提供原始 768P 视频及完全一致的原始输入）。

cURL - 按 source_task_idcURL - 按 base_video

bash

curl -X POST "https://api.agentsflare.com/minimax/v2/video_regeneration" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "source_task_id": "424010985738629",
    "resolution": "2K"
  }'

bash

curl -X POST "https://api.agentsflare.com/minimax/v2/video_regeneration" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      { "type": "text", "text": "一个男孩在海边打篮球" },
      {
        "type": "video_url",
        "video_url": { "url": "https://example.com/h3-768p-source.mp4" },
        "role": "base_video"
      }
    ],
    "resolution": "2K"
  }'

注意

该接口仅支持升级已经符合 MiniMax-H3 768P 输出规格的视频（24fps、宽高需为32的倍数、面积 ≤ 768×1344、总帧数107–362），不支持处理任意视频。

4. 查询任务

三种任务类型（generation、regeneration、h3_context_ir）共用同一个查询接口。任务结果仅可在 7 天内查询。

cURLPython

bash

curl -X GET "https://api.agentsflare.com/minimax/v2/query/video_generation/424010985738629" \
  -H "Authorization: Bearer YOUR_API_KEY"

python

import requests
import os

task_id = "424010985738629"
API_BASE = f"https://api.agentsflare.com/minimax/v2/query/video_generation/{task_id}"
API_KEY = os.getenv("API_KEY")

resp = requests.get(API_BASE, headers={"Authorization": f"Bearer {API_KEY}"})
result = resp.json()

status = result["task"]["status"]
print("Status:", status)
if status == "succeeded":
    print("Result:", result["task"]["content"])

响应示例

视频生成 — 成功

json

{
  "task": {
    "id": "424010985738629",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1785125529,
    "updated_at": 1785125946,
    "content": {
      "url": "https://your-cdn.example.com/h3-generated-2k-output.mp4"
    },
    "resolution": "2K",
    "duration": 5,
    "usage": {
      "total_seconds": 5,
      "input_seconds": 0,
      "output_seconds": 5,
      "input_image_count": 0
    },
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video"
  }
}

H3-Context-IR — 成功

json

{
  "task": {
    "id": "426586401755526",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1785702855,
    "updated_at": 1785702884,
    "content": {
      "prompt": "integrated_multimodal_description: [Shot 1] Cinematic, wide shot with a slow push in..."
    },
    "duration": 5,
    "usage": {
      "total_tokens": 9090,
      "prompt_tokens": 5664,
      "completion_tokens": 3426
    },
    "ratio": "16:9",
    "task_type": "h3_context_ir",
    "modality": "text"
  }
}

失败

json

{
  "task": {
    "id": "424010985738630",
    "model": "MiniMax-H3",
    "status": "failed",
    "error": { "code": "1026", "message": "video description contains sensitive content" },
    "created_at": 1785125529,
    "updated_at": 1785125700,
    "resolution": "2K",
    "duration": 5,
    "usage": { "total_seconds": 0, "input_seconds": 0, "output_seconds": 0, "input_image_count": 0 },
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video"
  }
}

响应字段说明

字段	说明
`status`	`queued` / `running` / `succeeded` / `failed` / `cancelled`
`task_type`	`generation` / `regeneration` / `h3_context_ir`
`modality`	`video`（生成/重生成）或 `text`（h3_context_ir）
`content.url`	视频下载地址（限时有效，请及时下载）— 视频类任务
`content.prompt`	增强后的提示词文本 — H3-Context-IR 任务
`usage.total_seconds` / `input_image_count`	视频类任务的计费用量
`usage.total_tokens` / `prompt_tokens` / `completion_tokens`	H3-Context-IR 任务的计费用量

注意事项

API Key 安全：请勿在代码中硬编码 API Key，建议使用环境变量
异步轮询：建议以 3–5 秒间隔轮询查询接口，而不是阻塞等待创建请求
7天查询窗口：任务结果仅可查询 7 天，请及时下载视频地址
图生视频与参考生视频互斥：同一请求中这两种输入模式不能混用

支持的模型

MiniMax-H3

💡 提示

请求示例中的 model 字段可替换为上方任意模型名称。

MiniMax-H3 API 示例 ​

基础配置 ​

接口一览 ​

请求参数（摘要） ​

请求示例 ​

1. 创建视频生成任务 ​

2. 创建 H3-Context-IR 任务（提示词增强） ​

3. 创建视频重生成任务（768P → 2K） ​

4. 查询任务 ​

响应示例 ​

视频生成 — 成功 ​

H3-Context-IR — 成功 ​

失败 ​

响应字段说明 ​

注意事项 ​

相关链接 ​

支持的模型 ​

MiniMax-H3 API 示例

基础配置

接口一览

请求参数（摘要）

请求示例

1. 创建视频生成任务

2. 创建 H3-Context-IR 任务（提示词增强）

3. 创建视频重生成任务（768P → 2K）

4. 查询任务

响应示例

视频生成 — 成功

H3-Context-IR — 成功

失败

响应字段说明

注意事项

相关链接

支持的模型