MiniMax H3 Max Turbo | BeatAPI API Documentation

POST https://api.beatapi.io/v1/videos/tasks

H3 Max 的加速版本：请求契约完全相同，速度约 2.5 倍，每秒单价减半。

支持的生成方式

生成方式	必填参数	使用规则
文生视频	`model`, `prompt`	不要传入 `images`。
首帧驱动	`model`, `prompt`, `images`	传入一个图片 URL。
首尾帧驱动	`model`, `prompt`, `images`	按首帧到尾帧的顺序传入两个图片 URL。

异步任务流程

创建任务后保存 data.id，每 5–10 秒调用 GET /v1/tasks/{task_id} 查询状态。status 为 succeeded 时读取 data.output.media，为 failed 时读取 data.error_code 和 data.error_message，随后按错误与重试策略处理。

使用本地文件

请先上传本地输入，再将返回的 data.url 填入请求。

鉴权

Authorization string 必填

在 Authorization 请求头中以 Bearer 令牌发送服务端 API 密钥，可在控制台创建。

Authorization: Bearer <BEATAPI_API_KEY>

永久 API 密钥只能保存在可信服务端，不能写入浏览器、移动端、公开脚本、日志或截图。请求体必须使用 Content-Type: application/json。建议为每个逻辑创建请求设置唯一的 Idempotency-Key，只有完全相同的请求体才能安全复用原键。

请求体

字段名、类型和枚举值保留英文原样，用途和限制用中文说明。

model string 必填

稳定的公开模型 ID，必须使用当前页面列出的值。

取值与默认值: 固定值 minimax-h3-max-turbo

prompt string 必填

描述生成、编辑或分析目标的提示词。

取值与默认值: 长度 1–5000 字符

images string[] 选填

按当前模型或工作流要求排序的公网 HTTPS 图片 URL 列表。

取值与默认值: 1–2 项

duration integer 选填

请求的输出时长，单位为秒。

取值与默认值: 默认值 5；最小值 1

resolution enum<string> 选填

输出素材的分辨率或质量档位。

取值与默认值: 可选值 480P、768P；默认值 768P

seed integer 选填

可复现生成结果的随机种子。按页面规则使用 -1 时会随机生成。

取值与默认值: 最小值 0

请求示例

文生视频

$ curl --request POST \
>   --url https://api.beatapi.io/v1/videos/tasks \
>   --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>   --header 'Content-Type: application/json' \
>   --data '{
>   "model": "minimax-h3-max-turbo",
>   "prompt": "A slow cinematic push through a misty mountain village at dawn.",
>   "duration": 5,
>   "resolution": "768P"
> }'

首帧驱动

$ curl --request POST \
>   --url https://api.beatapi.io/v1/videos/tasks \
>   --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>   --header 'Content-Type: application/json' \
>   --data '{
>   "model": "minimax-h3-max-turbo",
>   "prompt": "The performer turns toward the camera as neon light sweeps across the scene.",
>   "images": [
>     "https://media.beatapi.io/samples/neon-singer.png"
>   ],
>   "duration": 5,
>   "resolution": "768P"
> }'

首尾帧驱动

$ curl --request POST \
>   --url https://api.beatapi.io/v1/videos/tasks \
>   --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>   --header 'Content-Type: application/json' \
>   --data '{
>   "model": "minimax-h3-max-turbo",
>   "prompt": "Move smoothly from the opening portrait to the final product reveal.",
>   "images": [
>     "https://media.beatapi.io/samples/neon-singer.png",
>     "https://media.beatapi.io/samples/smart-bottle.png"
>   ],
>   "duration": 5,
>   "resolution": "480P"
> }'

响应

成功请求返回 HTTP 201，响应体如下。

1 {
2   "data": {
3     "id": "task_8K2qA",
4     "object": "task",
5     "task_kind": "video",
6     "capability_id": "minimax-h3-max-turbo",
7     "capability_version": null,
8     "media_type": "video",
9     "model": "minimax-h3-max-turbo",
10     "status": "queued",
11     "stage": "queued",
12     "created_at": 1782210000,
13     "updated_at": 1782210000,
14     "completed_at": null,
15     "output": null,
16     "usage": {
17       "credits_reserved": 0.2,
18       "credits_charged": 0.2,
19       "billable_duration_seconds": 5,
20       "credits_settled": 0,
21       "credits_refunded": 0
22     },
23     "request_id": "req_abc123",
24     "error_code": null,
25     "error_message": null
26   }
27 }

下一步

保存接受响应中的 data.id，每 5–10 秒轮询 GET /v1/tasks/{task_id}。任务成功后从 data.output.media 读取托管结果。

错误

状态码	含义与处理方式
`400`	请求字段、格式、取值或参数组合不合法，请修正后重新请求。
`401`	API 密钥缺失、无效或未启用。
`402`	USD 余额不足，请充值后再创建付费任务。
`409`	幂等键已对应其他请求体，仅能对完全相同的逻辑请求复用原键。
`429`	超过请求频率或并发上限，请遵守 `Retry-After` 或返回的等待时间。