MiniMax 生视频 API

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

模型简介

调用流程

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

• step1：调用创建任务接口，成功返回 task_id
• step2：用 task_id 轮询查询任务接口，直到 status 为 succeeded，从 content.url 取生成视频地址

创建任务接口详情

请求地址

POST https://ai.jw-info.com/v1/videos/generations

请求头

请求参数

请求示例

文生视频（注意 ratio 必须显式给）：

curl -X POST https://ai.jw-info.com/v1/videos/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的 API Key>" \
  -d '{
    "model": "minimax-h3",
    "content": [
      {"type": "text", "text": "复古 70 年代地铁站，街头音乐家弹奏吉他，路人匆匆走过，镜头缓慢右移"}
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

图生视频（首帧）：

{
  "model": "minimax-h3",
  "content": [
    {"type": "text", "text": "镜头缓慢推近，人物转头看向镜头"},
    {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}}
  ],
  "resolution": "768P",
  "duration": 5
}

响应参数

{"id": "442699662561545"}

查询任务接口详情

请求地址

GET https://ai.jw-info.com/v1/videos/generations/task/{task_id}

请求头

响应参数

与平台其它视频模型一致（方舟 schema，完整字段表见视频生成页）：

计费口径（平台按下列用量结算，响应里只回 usage.completion_tokens / usage.total_tokens）：

响应示例

{
  "id": "442699662561545",
  "model": "MiniMax-H3",
  "status": "succeeded",
  "created_at": 1789632761,
  "updated_at": 1789632877,
  "content": {"video_url": "https://…/output_aigc.mp4?Expires=…"},
  "resolution": "768P",
  "duration": 5,
  "ratio": "16:9",
  "usage": {
    "completion_tokens": 162745,
    "total_tokens": 162745
  }
}

用量与计费

• 按秒计费，人民币计价（精确到 0.000001 元，无最低消费）：total_seconds（输入参考视频秒数 + 输出视频秒数）× 分辨率档单价，单价见模型广场对应卡片。
• 输入图片按张计费（input_image_count）。
• 费用不进响应，到控制台「费用中心」查看明细。
• 任务失败时已扣费用原路退回，无需申请。

错误响应

错误体统一为方舟形状 {"error":{"code","message","param","type"}}（完整表格见视频生成页）：

{
  "error": {
    "code": "ResourceNotFound",
    "message": "The specified resource `442699662561545` is not found. Request id: 1f0c5b8e9a2d4c6f8b0e1a3d5c7f9b2e",
    "param": "",
    "type": "NotFound"
  }
}

完整状态码与处理方式见「错误码」页。

可用模型

见上文「模型简介」；更多视频模型见模型广场（筛选「文生视频」）。

代码示例（Python）

import time

import requests

BASE = "https://ai.jw-info.com"
API_KEY = "sk-你的密钥"
headers = {"Content-Type": "application/json",
           "Authorization": f"Bearer {API_KEY}"}

# 1. 创建任务
resp = requests.post(f"{BASE}/v1/videos/generations", headers=headers, json={
    "model": "minimax-h3",
    "content": [{"type": "text", "text": "海边日落，镜头缓慢推进"}],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9",
}, timeout=60)
task_id = resp.json()["id"]
print("task_id:", task_id)

# 2. 轮询直到 succeeded（通常数十秒到几分钟）
while True:
    task = requests.get(f"{BASE}/v1/videos/generations/task/{task_id}",
                        headers={"Authorization": f"Bearer {API_KEY}"},
                        timeout=60).json()
    if task["status"] in ("succeeded", "failed", "cancelled"):
        break
    time.sleep(5)

if task["status"] == "succeeded":
    print("视频地址:", task["content"]["video_url"])
    print("用量:", task["usage"])
else:
    print("任务未成功:", task["status"], task.get("error"))