HiAPI
博客

使用指南

Minimax H3 Max 短视频:通过 API 实测文生视频

一段历史遗留的 480P 横屏片段、它的 ffmpeg 竖屏转换,以及当前的帧图像输入与定价规则。

2026年11月3日
Minimax H3 Max 短视频:通过 API 实测文生视频

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 转换得到竖屏交付物。

立即开始构建持久 AI 产物

获取 API 密钥,通过一个基于任务(task)的 API 调用图像、视频和音频模型。

阅读 API 文档