MiniMax-视频生成

POST /v2/video_generation — MiniMax-H3 原生视频协议（文生/图生/参考生视频）

MiniMax-H3 视频生成模型，支持文生视频、图生视频（首帧/尾帧/首尾帧）与多模态参考生视频。这个家族走独立的原生入口，请求结构与 /api/v1 家族不同。

支持的模型

模型	说明
`MiniMax-H3`	MiniMax H3（模型名大小写不敏感，`minimax-h3` 等写法均可）

创建任务

POST/v2/video_generation

curl https://api.modelsite.ai/v2/video_generation \
  -H "Authorization: Bearer $MODELSITE_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [{ "type": "text", "text": "史诗级太空歌剧预告：女舰长站在观景窗前，舰队正在跃迁离去" }],
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 5
  }'

请求体（与 OpenAI 多模态 content[] 风格一致，全部平铺在顶层）

字段	类型	说明
`model`	string（必填）	`MiniMax-H3`（大小写不敏感）
`content`	array（必填）	内容数组，见下表。必须包含一个非空 `text` 项（prompt 必填）
`resolution`	string（必填）	`768P`（标准）/ `2K`（高清）
`duration`	integer（必填）	`[4, 15]` 的整数（秒）
`ratio`	string	宽高比，规则按任务类型：见下方

content 元素

type	字段	说明
`text`	`text`	提示词（必填其一，第一个 text 生效）
`image_url`	`image_url.url` + `role`	图像：`role` 为 `first_frame` / `last_frame`（各 ≤1 张，可省略 role 默认首帧）或 `reference_image`（≤9 张）。首帧/尾帧与参考类互斥
`video_url`	`video_url.url`	参考视频（多模态参考场景，≤3 段，单段 2~15s，总时长 ≤15s，≤50MB）
`audio_url`	`audio_url.url`	参考音频（≤3 段，单段 2~15s，≤15MB）

图像限制：JPG/JPEG/PNG/WEBP/HEIC/HEIF，宽高 [256, 5760]px，宽高比 0.4~2.5，≤30MB。

ratio 规则（按任务类型）

任务	规则
文生视频	必填，且不能为 `adaptive`：`21:9` / `16:9` / `4:3` / `1:1` / `3:4` / `9:16`
图生视频（首帧/尾帧）	恒为 `adaptive`（跟随输入图），传入其他值会被忽略
多模态参考生视频	可选，默认 `adaptive`，也可显式指定具体比例

其他厂商参数（如 callback_url）写在请求体顶层原样透传。

创建响应

{ "task_id": "enc_v2_xxxxx" }

轮询任务

GET/v2/query/video_generation/{task_id}

curl "https://api.modelsite.ai/v2/query/video_generation/$TASK_ID" \
  -H "Authorization: Bearer $MODELSITE_API_KEY"

{
  "task": {
    "id": "enc_v2_xxxxx",
    "status": "succeeded",
    "content": { "url": "https://.../video.mp4" }
  }
}

字段	说明
`task.id`	任务 ID（即创建时返回的令牌，原样回传）
`task.status`	小写：`queued` / `running` / `succeeded` / `failed`
`task.content.url`	生成视频 URL，仅成功时返回，尽快下载转存
`task.error`	仅失败时返回：`{"code": "...", "message": "..."}`

这个入口没有删除接口——任务创建后不能取消，请等待其终态。

计费

按实际生成时长（秒）计费，768P 与 2K 档位单价不同；任务失败不计费。单价见模型页。

错误处理

这个入口的错误结构与 /api/v1 不同，是 MiniMax 原生形态：

{
  "type": "error",
  "error": { "type": "bad_request_error", "message": "...", "http_code": "400" }
}

创建阶段的参数错误返回 400 + bad_request_error。通用平台错误（鉴权、限流、余额）见错误处理。

MiniMax-视频生成

支持的模型

创建任务

轮询任务

计费

错误处理

本页内容