使用指南
Minimax H3 Max 短视频:通过 API 实测文生视频
一段历史遗留的 480P 横屏片段、它的 ffmpeg 竖屏转换,以及当前的帧图像输入与定价规则。
MiniMax H3 Max 在纯文本生成时使用默认的横屏画布。若要生成竖屏短视频,需通过帧图像引导画布,或在后期制作阶段转换输出。下面的示例从一段 480P 横屏片段开始,并用 ffmpeg 将其转换为 9:16。
用此提示词生成 → 本示例选择 6 秒和 480P;纯文本输出使用默认横屏画布。
我们实际生成了什么
我们以文生视频模式,将这段完全相同的提示词发送给了 minimax-h3-max:
一位花艺师的双手在阳光照亮的 marble 台面上,用棕色牛皮纸包裹一束毛茛和尤加利叶,
然后用麻绳系成一个整齐的蝴蝶结;柔和的晨窗光,浅景深,特写竖屏构图,
温暖惬意的氛围,轻柔的纸张窸窣动态
用此提示词生成 → 选择 6 秒和 480P。
请求体:
{
"model": "minimax-h3-max",
"input": {
"prompt": "一位花艺师的双手在阳光照亮的 marble 台面上,用棕色牛皮纸包裹一束毛茛和尤加利叶,\n然后用麻绳系成一个整齐的蝴蝶结;柔和的晨窗光,浅景深,特写竖屏构图,\n温暖惬意的氛围,轻柔的纸张窸窣动态",
"duration": 6,
"resolution": "480P",
"aspect_ratio": "9:16"
}
}
我们请求了 9:16。以下是 API 返回的真实输出,逐字节呈现,未经任何编辑:
这段历史遗留的 480P 输出尺寸为 832×480。尽管请求中带有 9:16 值,它仍使用默认横屏画布;这与更新的 768P 样本不同,后者尺寸为 1344×768。
纯文本生成使用默认横屏画布
HiAPI 的模型说明写道:"纯文本生成使用默认横屏画布。"上面的原始请求遵循了这一行为:源片段为横屏,尽管提示词描述了竖屏构图,且请求中包含 aspect_ratio: "9:16"。
若需要不同的画布,请提供所需宽高比的 first_frame_image 或 last_frame_image。帧图像与 aspect_ratio 互斥,因此使用任一帧字段时须省略 aspect_ratio。你也可以保留横屏源,并在生成后进行裁剪或补边,如下所示。
用一条 ffmpeg 命令转为竖屏
将横屏帧裁剪为 9:16 会切掉花束的一半。因此我们改用了模糊背景的柱状补边方案:将源素材的强模糊副本缩放至填满竖屏画布,再把原始帧居中叠加在上方。
ffmpeg -y -i video.mp4 -filter_complex "\
[0:v]scale=720:1280:force_original_aspect_ratio=increase,crop=720:1280,gblur=sigma=20[bg];\
[0:v]scale=720:-1[fg];\
[bg][fg]overlay=(W-w)/2:(H-h)/2[out]" \
-map "[out]" -c:v libx264 -pix_fmt yuv420p -movflags +faststart video_vertical.mp4
一次处理,无需重新渲染,不丢失任何画面内容。以下是结果——同一段片段,现在是一个真正的 720x1280 竖屏文件:
这才是你真正会发布到 Reels、Shorts 或 TikTok 上的版本。
定价:这样一段片段实际花费多少
Minimax H3 Max 按输出秒数计费,并按分辨率分档(已在 hiapi 定价页确认):
- 480P — 每秒 $0.072
- 768P — 每秒 $0.115
时长范围为 5–15 秒。按当前费率,6 秒 480P 请求的视频预算为 $0.432;6 秒 768P 为 $0.69。按生成秒数做预算,并在任务账单记录中确认最终扣费。
相同时长下,768P 的成本约为 480P 的 1.60 倍。可用 480P 测试钩子和构图,再以 768P 渲染选中的镜头;四五次成功的 480P 草稿,成本仍高于一条同长度的 768P 片段。
常见问题
Minimax H3 Max 能直接生成竖屏视频吗?
纯文本生成使用默认横屏画布。若要 9:16,请使用该比例的帧图像并省略 aspect_ratio,或用裁剪、模糊补边叠加来转换横屏输出。
6 秒片段要花多少钱? 480P 为 $0.432($0.072/秒 × 6 秒),768P 为 $0.69($0.115/秒 × 6 秒)。
除价格外,480P 和 768P 还有什么区别? 768P 是更高保真的档位,每秒成本约为 480P 的 1.6 倍——值得用于最终发布渲染,但对测试提示词和构图来说则过于奢侈。
图生视频能避免这个方向问题吗?
API 文档支持通过帧图像决定输出画布。提供 first_frame_image 或 last_frame_image 并省略 aspect_ratio。本文视频展示的是纯文本源及其 ffmpeg 转换;它们不是图生视频样本。
自己试试
如果你想在写任何代码前测试提示词,Minimax H3 Max 模型页提供在线 Playground;我们的 Minimax H3 Max API 指南则端到端地介绍了认证与完整的请求/响应结构。
用此提示词生成 → 先生成一段 6 秒 480P 源素材,再用上面的 ffmpeg 转换得到竖屏交付物。