Skip to main content
POST

请求头

Authorization
string
必填

Bearer API Key,例如 Bearer sk-...。

示例:

"Bearer sk-..."

请求体

application/json

MiniMax-H3 创建视频请求体。

model
string
必填

模型 ID,固定使用 MiniMax-H3。

示例:

"MiniMax-H3"

prompt
string
必填

视频描述文本。也可用 content 中 type=text。

示例:

"一只猫在草地上奔跑,阳光明媚"

duration
integer

时长(秒),范围 4–30。也可用字符串 seconds。

必填范围: 4 <= x <= 30
示例:

5

seconds
string

duration 的字符串写法。

ratio
enum<string>

画幅。文生必填且不可 adaptive;图生固定 adaptive;多模态参考默认可 adaptive。

可用选项:
adaptive,
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
示例:

"16:9"

aspect_ratio
string

ratio 别名。

resolution
enum<string>

分辨率:480P / 768P / 1080P / 2K。

可用选项:
480P,
768P,
1080P,
2K
示例:

"2K"

image
string

单张首帧图 URL(与 first_frame 等价)。勿与 reference_* 混用。

images
string[]

图片 URL 数组;单张时常作首帧。

first_frame
string

首帧图 URL。别名:first_frame_url、input_reference。

last_frame
string

尾帧图 URL。别名:last_frame_url。

first_frame_url
string

first_frame 别名。

last_frame_url
string

last_frame 别名。

reference_images
string[]

多模态参考图。勿与首/尾帧混用。

reference_videos
string[]

多模态参考视频。

reference_audios
string[]

多模态参考音频。

context_ir_enabled
boolean

是否启用 Context IR(深度理解多模态素材)。也可走专用路径 /v1/videos/h3_context_ir。

callback_url
string

任务完成回调 URL。

content
object[]

原生多模态 content 数组(与扁平字段二选一或组合,规则同互斥)。

响应

任务已接受

id
string

任务 ID。

task_id
string
status
string
object
string