文生视频
写清楚人物、动作、镜头、光线和声音，H3 会把这些描述变成一段完整画面。
开发者快速接入
几分钟接入 MiniMax H3 API
邮箱已验证且有付费记录的用户，可以在 minimax3.com 创建 API Key，并在服务器、脚本或应用中使用站内积分。接口采用异步任务模式：先创建任务，再轮询状态，生成完成后获取视频。
1. 创建密钥
前往账户中的“API 密钥”，创建后立即复制并妥善保存。
2. 提交任务
发送 POST 请求，并带上唯一的 Idempotency-Key 请求头。
3. 查询结果
建议每隔约 5 秒查询一次任务地址，直到状态变为 succeeded。
接口地址
POST
/api/v1/videos创建视频任务
GET
/api/v1/videos/{task_id}查询单个任务或任务列表
GET
/api/v1/videos查询单个任务或任务列表
GET
/api/v1/videos/{task_id}/content使用同一个 Bearer API Key 下载成片
默认限制
- 每分钟最多创建 5 个任务
- 每个账户最多同时运行 2 个视频任务
- 每分钟最多查询 60 次状态
- 每个账户最多保留 3 个有效 API Key
可直接使用的调用示例
创建视频时必须发送唯一的 Idempotency-Key。使用同一个 Key 重试相同请求，会返回原任务，不会重复扣除积分。返回的 video_url 是私有地址，下载时也要带上同一个 Bearer API Key。
cURL · 创建一条 2K 视频
curl -X POST https://minimax3.com/api/v1/videos \
-H "Authorization: Bearer mmx_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: product-demo-001" \
-d '{
"model": "minimax-h3",
"mode": "text-to-video",
"prompt": "A cinematic product reveal with a slow camera move",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "2K"
}'JavaScript · 创建一条 2K 视频
const response = await fetch('https://minimax3.com/api/v1/videos', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.MINIMAX3_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
model: 'minimax-h3',
mode: 'text-to-video',
prompt: 'A cinematic product reveal with a slow camera move',
duration: 5,
aspect_ratio: '16:9',
resolution: '2K',
}),
});
const task = await response.json();
console.log(task.id, task.status);Python · 创建一条 2K 视频
import os
import uuid
import requests
response = requests.post(
"https://minimax3.com/api/v1/videos",
headers={
"Authorization": f"Bearer {os.environ['MINIMAX3_API_KEY']}",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"model": "minimax-h3",
"mode": "text-to-video",
"prompt": "A cinematic product reveal with a slow camera move",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "2K",
},
)
task = response.json()
print(task["id"], task["status"])cURL · 查询任务状态
curl https://minimax3.com/api/v1/videos/TASK_ID \
-H "Authorization: Bearer mmx_live_YOUR_API_KEY"cURL · 下载生成完成的视频
curl -L https://minimax3.com/api/v1/videos/TASK_ID/content \
-H "Authorization: Bearer mmx_live_YOUR_API_KEY" \
--output minimax-h3.mp4请求参数
| 字段 | 必填 | 说明 |
|---|---|---|
| model | 是 | 固定填写 minimax-h3。 |
| mode | 是 | text-to-video、image-to-video 或 reference-to-video。 |
| prompt | 是 | 视频描述，最多 7,000 个字符。 |
| duration | 否 | 4–15 秒的整数，默认 5 秒。 |
| aspect_ratio | 否 | 支持 21:9、16:9、4:3、1:1、3:4 和 9:16。 |
| resolution | 否 | 固定为 2K。 |
| image_url | 视模式而定 | 图生视频的 HTTPS 首帧图片地址。 |
| last_frame_url | 否 | 可选的 HTTPS 尾帧图片地址。 |
| reference_image_urls | 视模式而定 | 最多 9 个 HTTPS 参考图地址。 |
H3 可以做什么
MiniMax H3 API 支持哪些生成方式？
你可以从一句提示词开始，也可以上传图片，让 MiniMax H3 按照你的画面和风格继续创作。
图生视频
上传一张图片，再告诉 H3 画面要怎样运动；如果需要，还可以加入尾帧控制结尾。
参考图创作
需要保持人物、产品或画面风格时，可以加入参考图片，让前后效果更统一。
使用流程
怎样通过本站使用 MiniMax H3 API
你只需要准备创意和素材，任务提交、进度查询、成片保存以及失败任务的积分退回，都由本站在后台处理。
1. 准备
选择文生视频或图生视频，并写好提示词。
2. 生成
选择 4–15 秒时长，开始生成 2K 视频。
3. 查看
在“我的作品”里查看进度和成片。
4. 继续创作
下载视频、调整提示词，或者寻找新的灵感。
账户访问更安心
失败任务自动尝试退回积分
提示词结构
把你想要的画面讲清楚
一条好用的提示词通常会写清主体、动作、环境、镜头、光线、节奏和声音。最重要的要求放在前面，尽量不要加入互相冲突的描述。
一块拉丝银色智能手表悬浮在黑色反光桌面上缓慢旋转，镜头徐徐推进，紫色柔光勾边，高级产品广告节奏，细微机械环境音，16:9。
MiniMax H3 API 常见问题
MiniMax H3 现在可以在线使用吗？
可以。你可以在本站使用 MiniMax H3 生成 2K 文生视频和图生视频，时长为 4–15 秒。
需要自己准备 MiniMax H3 API Key 吗？
在网页上生成视频不需要 API Key。开发者可以在账户设置中创建 minimax3.com API Key，并使用同一套站内积分调用接口。
MiniMax H3 API 怎么收费？
在本站生成 H3 视频时，主要按照视频时长消耗积分。你可以先查看价格页面，了解当前积分套餐，再根据自己的使用量选择。
现在有公开的开发者接口吗？
有。邮箱已验证且有付费记录的用户可以创建 API Key，调用 POST /api/v1/videos 创建任务，再通过 GET /api/v1/videos/{task_id} 查询结果。
生成失败后怎么处理？
系统会记录失败任务，并按照站内积分规则，自动尝试退回这次生成所消耗的积分。