免费 MiniMax H3 API:带声音的视频,零成本
MiniMax H3 现在在 Revana 上有了免费档。我们在自己的 GPU 上渲染,所以一段视频对你来说不花一分钱:输入文本或图片,输出一段 5 到 15 秒带声音的视频。下面介绍它能做什么、队列如何运作,以及调用它的代码。
MiniMax H3 免费版是什么
minimax-h3-free 是通过 FastH3 Omni 运行的 MiniMax H3,这是一个蒸馏版本,用 8 步完成渲染,而不是完整的流程。它运行在我们自有的 GPU 上,而不是付费的供应商上,这就是我们能免费提供的原因。每段视频都带有随画面一起生成的声音:脚步声、人声、音乐、环境声。
| 模型 id | minimax-h3-free |
|---|---|
| 功能 | 文生视频、图生视频(起始图片)、参考图片 |
| 分辨率 | 480p、720p、768p(768×1344 竖版) |
| 宽高比 | 9:16, 16:9, 1:1 |
| 时长 | 5 到 15 秒 |
| 声音 | 始终带声音,随画面一起生成 |
| 图片 | 总共最多四张 |
| 价格 | free |
| 同时运行 | 每个账户 10 个任务,包括排队中和运行中的 |
它是与付费的 minimax-h3 不同的模型 id。付费模型不受任何影响,每次请求你可以选择调用哪一个。
免费队列如何运作
一块 GPU 一次只生成一段视频,所以免费任务轮流进行:
- 你的任务会被立即接收。
POST /v1/generations与其他任何模型一样,会返回202和一个 id,在 GPU 有空位之前,任务显示为queued。 - 按账户轮流。当很多人在等待时,GPU 会从队列中下一个账户取下一个任务,所以某个账户一次发送大量任务,不会把其他人的任务往后挤。
- 每个账户同时十个。你最多可以有 10 个免费任务在排队或运行。第十一个会被拒绝,并返回
429 concurrency_limit;等某个任务结束后再重新发送。 - 最长等待三小时。超过这个时间仍在等待的任务会以
model_busy失败,不收费。
任务一旦到达 GPU,在 768p 下大约用 12 秒加上视频每秒 10 秒完成渲染,所以一段 5 秒的视频大约需要一分钟。大约每 10 秒轮询一次;文档介绍了任务可能显示的所有状态。
用文本生成一段免费视频
请求与 Revana 上的所有模型相同。无需设置 max_cost_usd,也无需先购买额度。
export REVANA_API_KEY="sr_live_..."
# 1. Submit the job (returns 202 with the generation id)
curl https://api.revana.si/v1/generations \
-H "Authorization: Bearer $REVANA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-free",
"input": {
"prompt": "A street drummer plays on upturned buckets on a busy corner at night, coins in a hat at his feet, passers-by slowing to watch. The drums echo off the buildings.",
"resolution": "768p",
"aspect_ratio": "9:16",
"duration": 8
}
}'
# 2. Poll with the id from step 1 until status is "succeeded" or "failed"
curl https://api.revana.si/v1/generations/gen_01JC2V8K5T \
-H "Authorization: Bearer $REVANA_API_KEY"从图片开始
通过 image_url 发送一张起始图片,视频会以它开场,并保留其中的人物、物体和场景。再通过 image_urls 最多添加三张(总共四张),并在提示词中用尖括号括住名称来引用它们(Picture 1、Picture 2 等)。图片为 PNG、JPEG、WebP 或 GIF,需是公开的 https 链接;如果你只有本地文件,请先用 POST /v1/uploads 上传。
import os
import time
import requests
API = "https://api.revana.si/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['REVANA_API_KEY']}"}
resp = requests.post(f"{API}/generations", headers=HEADERS, json={
"model": "minimax-h3-free",
"input": {
"prompt": "<Picture 1> turns to the camera and smiles, then walks out of frame. Soft cafe chatter.",
"image_url": "https://example.com/portrait.jpg",
"duration": 5,
},
})
resp.raise_for_status()
job = resp.json()
# A free job may wait in the GPU queue before it renders, so poll patiently
while job["status"] in ("queued", "running"):
time.sleep(10)
job = requests.get(f"{API}/generations/{job['id']}", headers=HEADERS).json()
if job["status"] == "succeeded":
print(job["output"]["urls"])
else:
print("Failed:", job["error"])FastH3 Omni 做不到的一切都会立刻被拒绝,并返回 422 invalid_input:1080p 或 2K 分辨率、21:9 画幅、短于 5 秒或长于 15 秒的视频、audio: false、视频输入,或超过四张图片。这些情况请使用付费的 minimax-h3。
免费还是付费的 MiniMax H3?
免费模型适合试想法、画分镜草稿,以及制作 768p 就够用的社交媒体短视频。需要 2K、更宽的画幅、首帧和尾帧、更多参考图,或者希望视频立即开始生成时,请用付费模型。
minimax-h3-free | minimax-h3 | |
|---|---|---|
| 价格 | free | 每秒 $0.03 起 |
| 引擎 | FastH3 Omni:8 步的 MiniMax H3,运行在我们的 GPU 上 | 完整步数的 MiniMax H3,运行在付费线路上 |
| 分辨率 | 最高 768p | 768p 和 2K |
| 宽高比 | 9:16, 16:9, 1:1 | 更多,包括 21:9 |
| 首帧和尾帧 | no | yes |
| 参考图片 | 最多 4 张 | 最多 9 张 |
| 等待 | 与免费通道上的其他所有人一起排队 | 立即开始 |
完整的模型阵容见 Hailuo 和 MiniMax 指南,最便宜的视频 API 指南介绍了每个付费模型的最低价格。所有模型都在模型页面上,额度包见价格页面,你也可以获取 API 密钥来运行这些示例。
常见问题
MiniMax H3 免费 API 真的免费吗?
是的。minimax-h3-free 上的任务报价、预留和扣费都是零,所以没有额度的账户也能使用。失败的任务同样不收费。
minimax-h3-free 和 minimax-h3 有什么区别?
minimax-h3-free 是蒸馏为 8 步的 MiniMax H3(FastH3 Omni),在我们自己的 GPU 上渲染,最高 768p。minimax-h3 是 MiniMax 在付费线路上的完整模型,支持 2K、更多宽高比以及首帧和尾帧。两者都能生成声音。
我可以同时运行多少个免费任务?
每个账户十个,包括排队中和运行中的。第十一个会被拒绝,并返回 429 concurrency_limit,直到你的某个任务结束。
一段免费视频需要多久?
开始渲染后,大约 12 秒加上视频每秒 10 秒,所以一段 5 秒的视频大约需要一分钟。GPU 繁忙时,你的任务会先在队列中等待,与其他账户轮流,最长三小时。
我可以发送自己的图片吗?
可以。通过 image_url 发送一张起始图片,通过 image_urls 发送最多四张参考图片,总共四张,均为 https 链接。在提示词中用尖括号括住名称来引用它们(Picture 1、Picture 2 等)。