MiniMax H3 视频

MiniMax H3 使用 OpenAI Video 兼容任务接口。创建任务支持 application/json 和 multipart/form-data。

Base URL

账号 Base URL 支持 http:// 和 https://，必须填写纯 origin，例如：

text

https://video.ctmoai.com
http://video.ctmoai.com

不要填写 Apifox 文档地址、/v1、/docs/minimax-h3 等路径，也不要携带用户名、密码、查询参数或片段。API 请求会自动追加 /v1/videos 等接口路径。

接口路径

操作	方法与路径
创建视频	`POST /v1/videos`
查询任务	`GET /v1/videos/{task_id}`
下载视频	`GET /v1/videos/{task_id}/content`
公开视频	`GET /v1/videos/public/{task_id}`（无需 API Key，支持 Range）
上传参考图	`POST /api/sd-media/upload`

创建视频

没有本地参考图时可使用 JSON；需要直接上传本地图片时使用 multipart。seconds 支持 4-15 秒，省略时按 4 秒处理。

JSONJSON + 参考图 URLmultipart 本地参考图

bash

curl "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax_h3",
    "prompt": "清晨的海岸公路，镜头平稳向前推进，电影感",
    "seconds": 6,
    "workflow_id": "text-to-video",
    "size": "1376x768"
  }'

bash

curl "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax_h3",
    "prompt": "保持角色设定，转身看向镜头",
    "seconds": 6,
    "workflow_id": "fl2v",
    "size": "1376x768",
    "input_reference": "https://example.com/reference.png"
  }'

bash

curl "$BASE_URL/v1/videos" \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=minimax_h3" \
  -F "prompt=保持角色设定，转身看向镜头" \
  -F "seconds=6" \
  -F "workflow_id=fl2v" \
  -F "size=1376x768" \
  -F "input_reference=@./reference.png"

文档接口统一使用 minimax_h3，可显式指定 workflow_id（省略时网关按 text-to-video 兼容处理）。旧客户端传 mode=first_last_frame 或 first_last_frame=true 时会自动兼容为 fl2v 工作流。标准工作流支持 size 为 480P、768P、1080P 对应的标准画布；cf-multi-reference、cf-fl2v、cf-mj 还支持 size 为 2K 或 4K，并要求同时传 aspect_ratio。duration 是 seconds 的兼容别名，提示词增强可通过 prompt_enhance 控制。请求中的未知扩展字段会继续透传。

可用工作流包括 text-to-video、multi-reference、multi-reference-4、lh-multi-reference、fl2v、cf-multi-reference、cf-fl2v、mj 和 cf-mj。图片可使用 input_reference 或 images，视频和音频可使用 reference_video(s)、reference_audio(s)；也可以用 multipart 直接上传二进制文件。

查询与下载

创建成功后保存响应中的 id 或 task_id，每 5-10 秒查询一次状态：

bash

curl "$BASE_URL/v1/videos/TASK_ID" \
  -H "Authorization: Bearer $API_KEY"

状态完成后下载 MP4：

bash

curl "$BASE_URL/v1/videos/TASK_ID/content" \
  -H "Authorization: Bearer $API_KEY" \
  --output result.mp4

公开视频接口无需携带 API Key，适合直接放入 <video> 标签；返回 video/mp4，支持 Range 断点播放：

bash

curl "$BASE_URL/v1/videos/public/TASK_ID" \
  -H "Range: bytes=0-1023" \
  --output result.part

创建请求超时或连接中断时不要直接重复提交同一个 POST。应先按已有任务 ID 查询，避免上游已经创建并计费后又生成一份。

常见错误

Request body must be a JSON object or multipart/form-data：请求格式或 multipart 边界不正确。
Unsupported MiniMax H3 model：模型不在当前 MiniMax H3 模型目录中；文档接口应使用 minimax_h3。
workflow_id is not supported by MiniMax H3：工作流名称不在文档支持列表中。
MiniMax H3 CF workflows require size 2K or 4K：CF 超分工作流缺少合法的 2K/4K 尺寸。
This MiniMax H3 CF model requires input_reference or images：旧版 CF 模型缺少参考图。
billing_configuration_error：管理员尚未为该模型配置 USD/秒价格。
no_available_accounts：当前分组没有已启用、已绑定且支持该模型的 MiniMax 账号。

MiniMax H3 视频 ​

Base URL ​

接口路径 ​

创建视频 ​

查询与下载 ​

常见错误 ​

MiniMax H3 视频

Base URL

接口路径

创建视频

查询与下载

常见错误