Model CenterGlobalAiOpc

MiniMax H3 Video Generation

POST/kyyReactApiServer/v2/model-center/tasks

Model information

Field	Value
Model ID (`model`)	`minimax-h3`
Model name	MiniMax H3 Video Generation
Model type	Video models
Set the request `model` field to the Model ID shown above. Using the model name will fail to resolve the model.

Authentication

Get Key

All requests must include a Bearer token in the request headers:

cURL

Authorization: Bearer <API_KEY>

Request parameters

Send the following fields in the JSON request body. model is required — use the Model ID from the Model information section above.

promptstringrequired

Prompt

文本提示词输入。prompt 字符数不能超过 2000。 prompt 建议避免违规、侵权、涉政、涉黄等高风险内容。

Range：1 – 2000

reference_imagesimage[]

Reference images

内部统一参考图片输入；

Range：0 – 5

Items：0 - 5

Provide a publicly accessible resource URL.

reference_audiosaudio[]

Reference audios

参考音频输入。音频参考必须同时提供至少一张图片参考。音频参考必须与图片参考一起使用。

音频参考支持 1 个，mp3、wav、m4a、aac、ogg、webm 等常见音频格式，时长限制2-15秒，内存不大于15m。

Range：0 – 1

Items：0 - 1

Provide a publicly accessible resource URL.

durationinteger

Duration

Generated video duration.

Range：5 – 15

Default：5

aspect_ratiostring

Aspect ratio

输出画幅比例。与size冲突

Allowed values：16:9, 9:16, 1:1, 4:3, 3:4, 21:9

Default：16:9

sizestring

Size

输出尺寸或像素规格。与aspect_ratio冲突

Allowed values：2560x1440, 1440x2560, 1440x1440, 1920x1440, 1440x1920, 3360x1440

Default：2560x1440

first_imageimage[]

First frame

First-frame image input.

Range：0 – 1

Items：0 - 1

Provide a publicly accessible resource URL.

last_imageimage[]

Last frame

Last-frame image constraint.

Range：0 – 1

Items：0 - 1

Provide a publicly accessible resource URL.

Response contract

Task status is normalized to queued, processing, completed, or failed. Result URLs are returned only when status is completed;

Field	Description
`id`	Task ID used to poll status and results.
`object`	Resource type, usually `video` for this model.
`created`	Task creation time as a Unix timestamp in seconds.
`model`	Model name used for this request.
`status`	`queued`, `processing`, `completed`, or `failed`.
`progress`	Task progress, usually returned by the query API.
`result_url`	Generic result URL, returned only after completion.
`video_url`	Typed result URL for this resource, returned only after completion.
`amount`	Credits consumed by this task.
`actualDuration`	Duration used by this task.
`error`	Error message on failure; usually `null` while queued, processing, or completed.

Query task result

Generation tasks run asynchronously. The submit endpoint returns a task id; poll the query endpoint below with that id until status becomes completed or failed.

http

GET https://zcbservice.aizfw.cn/kyyReactApiServer/v2/model-center/tasks/{id}
Authorization: Bearer <API_KEY>

idstringrequired

The task ID returned by the submit endpoint.

When status is completed, the result URL is returned via result_url and video_url. See the Response contract above for the remaining fields.

Poll every 5–10 seconds and stop once status is completed or failed. Result URLs expire, so download and store them promptly.