MiniMax H3 Fast 视频生成

model = minimax-h3-fast·¥0.04/秒

异步处理模式：提交后立即返回 task_id，再轮询任务接口
OpenAI 兼容视频接口：POST /v1/videos + GET /v1/videos/{id}，通用 OpenAI 客户端可直接调用
原生异步接口：POST /api/v1/videos/generations + GET /api/v1/tasks/{task_id}
通过 resolution 控制：480p / 768p
时长 5–15 秒
参考图最多 9 张（URL / base64）
渠道：标准渠道 · 售价 ¥0.04/秒 · 失败自动退款

POST /api/v1/videos/generations

模型页试一试 →

标准渠道

本模型为标准（经济）路由。同族若存在「官方渠道」条目，可在左侧目录展开切换。

模型 ID

请求体 model 必须为 minimax-h3-fast。

简介

MiniMax H3 Fast 视频模型，提供 480p 与 768p 分辨率选项，支持文生视频、图生视频、首尾帧、全能多参考及视频重绘等全场景创作，带同步原生音频。

Authorizations

需要 Bearer Token。在 API Key 管理创建后，请求头加入：

Authorization: Bearer sk-你的API_Key

Base URL：https://xiaoguai123.xyz

Body

模型名称

固定填写 minimax-h3-fast

视频生成的文本描述

支持中英文，建议详细描述
可能触发内容安全策略，违规会直接报错

mode

见取值说明
可选：文生视频 / 图生视频 / 首尾帧 / 全能多参 / 视频转视频 / 参考改视频
默认："文生视频"

使用场景示例

文生视频（最简）

{
  "model": "minimax-h3-fast",
  "prompt": "镜头缓缓推进，瀑布与彩虹，自然光"
}

带默认参数的完整示例

{
  "model": "minimax-h3-fast",
  "prompt": "镜头缓缓推进，瀑布与彩虹，自然光",
  "mode": "文生视频",
  "duration": 5,
  "resolution": "480p",
  "aspect_ratio": "16:9"
}

图生视频

{
  "model": "minimax-h3-fast",
  "prompt": "让画面中的主体缓缓移动",
  "image_urls": [
    "https://example.com/ref.jpg"
  ],
  "duration": 5
}

Response

提交成功时返回任务数组：

status：如 submitted（已提交）
task_id：任务唯一标识，用于后续查询

查询任务结果

GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}
Authorization: Bearer sk-你的API_Key

• 提交（OpenAI 兼容）：POST https://xiaoguai123.xyz/v1/videos

• 查询（OpenAI 兼容）：GET https://xiaoguai123.xyz/v1/videos/{id}

• 提交（原生）：POST https://xiaoguai123.xyz/api/v1/videos/generations

• 查询（原生）：GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}

• status=completed 时读取 result.images / result.videos；failed 已自动退款

详见任务查询接口。

状态	含义
pending / submitted	已提交或排队
processing	上游处理中
completed	成功，result 可用
failed	失败，已自动退款

REQUEST

curl -X POST https://xiaoguai123.xyz/api/v1/videos/generations \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{ "model": "minimax-h3-fast", "prompt": "镜头缓缓推进，瀑布与彩虹，自然光", "duration": 5, "resolution": "480p", "aspect_ratio": "16:9" }'

RESPONSE

成功提交

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "xg_01hxyz..."
    }
  ]
}