MiniMax-H3

睿枢智算 MiniMax H3 API 接口文档

版本 v2.0 | 视频生成 & 素材管理

Base URLhttps://mjlm.coral-gpu.com:3000/v1

鉴权方式Authorization: Bearer <your-api-key>

视频生成/v1/video/generations

素材管理/v1/uploads

计费与余额/v1/usage / /v1/billing

第一部分：视频生成

1. 创建视频任务

项目	值
方法	POST
路径	/v1/video/generations
Content-Type	application/json
超时	60 秒

请求参数:

参数	类型	必填	说明
model	string	是	固定值 minimax-h3
prompt	string	是	提示词，上限 2500 字
size	string	否	576 / 720P（默认）/ 720P-l（横屏）
seconds	integer	否	5~16 秒，默认 15
template_id	string	否	内置模板 ID
image_uploads	string[]	否	参考图 upload_id（最多 9 张）
video_upload	string	否	参考视频 upload_id
audio_upload	string	否	参考音频 upload_id
use_video_audio	boolean	否	用参考视频原声
audio_start	number	否	音频起始秒
audio_end	number	否	音频结束秒
subtitle	boolean	否	中文字幕
ref_mode	string	否	first / last / prompt
count	integer	否	生成条数 1~99999
seed	integer	否	随机种子
idle_gen	boolean	否	闲时生成

分辨率说明:

size	竖屏	横屏	说明
576	576x1024	1024x576	走量档
720P	736x1280	1280x736	主力档
1080P	1088x1920	1920x1088	暂无资源

请求示例:

json

{"model":"minimax-h3","prompt":"夜晚霓虹天台","size":"720P","seconds":5}

json

{"model":"minimax-h3","prompt":"根据参考图生成","image_uploads":["upload_id"],"seconds":10,"subtitle":true}

返回示例:

json

{"task_id":"96f33d03-...","status":"queued","model":"minimax-h3"}

2. 查询视频任务

项目	值
方法	GET
路径	/v1/video/generations/{task_id}?model=minimax-h3
说明	轮询直到 succeeded / failed / cancelled

返回示例:

json

{"task_id":"...","status":"succeeded","progress":100,"download_url":"/v1/results/.../download","duration_seconds":100}

3. 下载视频

项目	值
方法	GET
路径	/v1/results/{task_id}/download
说明	返回 MP4 文件流，支持断点续传

4. 取消任务

项目	值
方法	POST
路径	/v1/video/generations/{task_id}/cancel
说明	取消任务，未成功不扣费

项目	值
方法	POST
路径	/v1/results/{task_id}/share
说明	生成免鉴权临时直链

请求体:

json

{"hours": 24}

json

{"share_url": "/v1/share/xxx", "expires_in_hours": 24}

项目	值
方法	GET
路径	/v1/share/{token}
说明	浏览器直接打开，无需鉴权

第二部分：素材管理

1. 上传素材（本地文件）

项目	值
方法	POST
路径	/v1/uploads
Content-Type	multipart/form-data
说明	一次上传一个文件

请求参数:

参数	类型	必填	说明
file	file	是	文件二进制流
kind	string	否	image / audio / video（默认 image）

文件格式支持:

类型	格式	大小上限
image	PNG / JPG / WebP	10 MB
audio	MP3 / WAV / M4A / FLAC / OGG	20 MB
video	MP4 / MOV / WebM	30 MB

返回示例:

json

{"upload_id":"f52a3bc7-...","name":"cover.jpg","kind":"image","size":204800,"width":1024,"height":1024}

2. 分片上传（大文件备用）

三步流程：init -> chunk -> complete

2.1 初始化

项目	值
方法	POST
路径	/v1/uploads/init
说明	声明文件元信息，获取 upload_id 和分片规格

请求体:

json

{"name":"bgm.mp3","kind":"audio","size":16527,"chunks":1}

json

{"upload_id":"...","chunk_bytes":40000,"max_b64_chars":56000}

2.2 上传分片

项目	值
方法	POST
路径	/v1/uploads/chunk
说明	每片为 base64 字符串，index 从 0 开始

请求体:

json

{"upload_id":"...","index":0,"data":"<base64>"}

2.3 完成上传

项目	值
方法	POST
路径	/v1/uploads/complete
说明	拼装校验，得到正式 upload_id

请求体:

json

{"upload_id":"..."}

3. 素材列表

项目	值
方法	GET
路径	/v1/uploads
说明	返回本 KEY 名下有效素材（最多 100 条，新的在前）

返回示例:

json

{"data":[{"upload_id":"...","name":"bgm.mp3","kind":"audio","size":16527,"created_at":"2026-08-18T03:35:01Z","download_url":"/v1/uploads/..."}]}

4. 下载素材

项目	值
方法	GET
路径	/v1/uploads/{upload_id}
说明	下载已上传素材的原文件

第三部分：计费与余额

1. 查询用量

项目	值
方法	GET
路径	/v1/usage
说明	本 KEY 用量流水（每条任务的计费/退款记录）

2. 查询账单

项目	值
方法	GET
路径	/v1/billing
说明	账单汇总（按天/按档位聚合）

第四部分：错误码

code	HTTP	说明
invalid_api_key	401	API Key 错误或已吊销
quota_exhausted	429	余额不足
invalid_request	400	参数错误
task_not_exist	404	任务不存在
not_ready	409	任务未完成，暂不可下载
pull_pending	409	成片副本同步中，稍后重试
file_gone	410	超过留存期
share_expired	410	分享链接过期

第一部分：视频生成

1. 创建视频任务

2. 查询视频任务

3. 下载视频

4. 取消任务

5. 生成分享链接

6. 免鉴权下载

第二部分：素材管理

1. 上传素材（本地文件）

2. 分片上传（大文件备用）

2.1 初始化

2.2 上传分片

2.3 完成上传

3. 素材列表

4. 下载素材

第三部分：计费与余额

1. 查询用量

2. 查询账单

第四部分：错误码