AI Video API一个模型，两种专注工作流
常用的纯文本路径保持简洁，同时在需要确定场景起止画面时提供首尾帧控制。
快速文生视频与图生视频 API
MiniMax H3 Max API
通过文本或可控首尾帧，生成 480p 或 768p 视频。
MiniMax H3 Max 通过统一异步 API 提供专注的文生视频和首尾帧图生视频能力。可生成 5–15 秒视频，纯文本模式支持六种固定比例，帧控制模式可提供一至两张图片。费用仅由输出时长和分辨率决定，输入图片免费。
查看官方模型与计费文档5–15 秒
输出时长
480p / 768p
分辨率
仅输出计费
计费方式
MiniMax
minimax-h3-maxH3 系列效果示例
5–15 秒
输出时长
480p / 768p
分辨率
仅输出计费
计费方式
模型能力
为生产级 API 工作流设计，不只是演示。
MiniMax H3 Max 与你接入的其他视频和图片模型共用同一套 API Key、积分、日志、Webhook 和文档体系。
默认纯文本生成
省略 generation_type 即可直接根据提示词生成视频。可选择 21:9、16:9、4:3、1:1、3:4 或 9:16，参考媒体不会发送到上游。
首尾帧控制
将 generation_type 设为 first_and_last_frames，一张图片控制首帧，两张图片分别控制首帧和尾帧；帧模式自动跟随图片构图。
仅输出计费
输入图片不收取积分。预估和最终扣费均使用输出分辨率对应的每秒价格，提交前即可准确判断成本。
生产级异步流程
通过统一视频端点提交，立即获得任务 ID，再通过回调或状态轮询获取托管视频，任务结构与平台其他模型一致。
API 工作流
提交任务、跟踪进度、取回生成结果。
01
选择文本或帧模式
文生视频不传 generation_type；图生视频则显式选择 first_and_last_frames，并传入一至两个公开 HTTP(S) 图片地址。
02
设置输出参数
时长选择 5–15 秒整数，分辨率选择 480p 或 768p。文本模式支持六种固定比例，帧模式根据输入图片确定比例。
03
提交并获取结果
向统一生成端点发起 POST 请求，再通过任务 ID 轮询或使用回调。积分只由输出分辨率和成功输出秒数决定。
POST /v1/videos/generations
curl -X POST https://api.aivideoapi.ai/v1/videos/generations \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-max",
"input": {
"prompt": "A cinematic tracking shot through a rain-lit night market",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
}
}'典型应用场景
短视频营销素材
商品与电商动态展示
社交媒体视频变体
分镜到视频预览
首尾画面转场
快速概念可视化
为什么选择 MiniMax H3 Max
开发者关心的 MiniMax H3 Max API 优势。
成本易于预估
只有分辨率和输出秒数影响积分；文本模式中被忽略的图片和有效帧图片都不会增加输入费用。
统一接入体验
沿用已有任务轮询、回调、托管输出、鉴权和权限控制，无需维护单独的集成栈。
常见问题
关于 MiniMax H3 Max API 的常见问题解答。
如何请求纯文本 T2V？
省略 generation_type。即使请求中带有字符串数组 image_urls，也会全部忽略，不转发且不计费。
图生视频可以使用几张图片？
first_and_last_frames 模式必须提供一至两个有效 HTTP(S) 图片地址。第一张映射首帧，第二张存在时映射尾帧。
支持哪些分辨率和时长？
可选择 480p 或 768p，以及 5–15 秒的整数时长；默认值为 768p 和 5 秒。
提交后可以取消任务吗？
不可以。该模型不支持任务取消，请通过轮询或回调等待最终任务状态。
定价与用量
清晰的模型选项，共享积分余额。
480p 输出
12.7 积分/秒
5 秒输出为 63.5 积分
768p 输出
19.23 积分/秒
默认档位；5 秒输出为 96.15 积分
输入图片
免费
帧模式使用一至两张图片，不收取输入素材费用
在 AI Video API 上开始使用 MiniMax H3 Max。
一个 API Key、一份积分余额，在视频和图片模型之间无缝切换，无需为每家供应商单独接入。