curl --request POST \
--url https://api.omniall.ai/v1/videos \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "MiniMax-H3",
"prompt": "一只猫在草地上奔跑，阳光明媚",
"duration": 5,
"resolution": "2K",
"ratio": "16:9"
}
'{
"id": "task_xxx",
"task_id": "task_xxx",
"status": "queued"
}创建视频
MiniMax-H3 异步创建视频。
路径： POST https://api.omniall.ai/v1/videos
亦可使用 POST /v1/video/generations。支持文生 / 图生（首尾帧）/ 多模态参考；分辨率 480P / 768P / 1080P / 2K，时长 4–30 秒。
模式互斥： first_frame / last_frame（含 image、images[0]、first_frame_url 等）与 reference_images / reference_videos / reference_audios（或 content 中的 reference_*）不能同时使用。
等价字段： first_frame_url ≈ first_frame ≈ image ≈ images[0]。
ratio 规则：
- 文生视频（t2va）：仅文本时
ratio必填，且不能为adaptive（可选21:9/16:9/4:3/1:1/3:4/9:16） - 图生视频（i2va）：含首/尾帧时，输出比例跟随输入图，
ratio固定为adaptive（传其它值会被忽略） - 多模态参考（r2va）：含
reference_*时ratio可选，默认adaptive，也可指定固定比例
鉴权：Authorization: Bearer sk-...
curl --request POST \
--url https://api.omniall.ai/v1/videos \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "MiniMax-H3",
"prompt": "一只猫在草地上奔跑，阳光明媚",
"duration": 5,
"resolution": "2K",
"ratio": "16:9"
}
'{
"id": "task_xxx",
"task_id": "task_xxx",
"status": "queued"
}请求头
Bearer API Key，例如 Bearer sk-...。
"Bearer sk-..."
请求体
MiniMax-H3 创建视频请求体。
模型 ID，固定使用 MiniMax-H3。
"MiniMax-H3"
视频描述文本。也可用 content 中 type=text。
"一只猫在草地上奔跑，阳光明媚"
时长（秒），范围 4–30。也可用字符串 seconds。
4 <= x <= 305
duration 的字符串写法。
画幅。文生必填且不可 adaptive；图生固定 adaptive；多模态参考默认可 adaptive。
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 "16:9"
ratio 别名。
分辨率：480P / 768P / 1080P / 2K。
480P, 768P, 1080P, 2K "2K"
单张首帧图 URL（与 first_frame 等价）。勿与 reference_* 混用。
图片 URL 数组；单张时常作首帧。
首帧图 URL。别名：first_frame_url、input_reference。
尾帧图 URL。别名：last_frame_url。
first_frame 别名。
last_frame 别名。
多模态参考图。勿与首/尾帧混用。
多模态参考视频。
多模态参考音频。
是否启用 Context IR（深度理解多模态素材）。也可走专用路径 /v1/videos/h3_context_ir。
任务完成回调 URL。
原生多模态 content 数组（与扁平字段二选一或组合，规则同互斥）。
Show child attributes
Show child attributes