公告

免费 MiniMax H3 API:带声音的视频,零成本

MiniMax H3 现在在 Revana 上有了免费档。我们在自己的 GPU 上渲染,所以一段视频对你来说不花一分钱:输入文本或图片,输出一段 5 到 15 秒带声音的视频。下面介绍它能做什么、队列如何运作,以及调用它的代码。

MiniMax H3 免费版是什么

minimax-h3-free 是通过 FastH3 Omni 运行的 MiniMax H3,这是一个蒸馏版本,用 8 步完成渲染,而不是完整的流程。它运行在我们自有的 GPU 上,而不是付费的供应商上,这就是我们能免费提供的原因。每段视频都带有随画面一起生成的声音:脚步声、人声、音乐、环境声。

MiniMax H3 免费版一览
模型 idminimax-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,也无需先购买额度。

cURL
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 上传。

Python
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 对比
minimax-h3-freeminimax-h3
价格free每秒 $0.03 起
引擎FastH3 Omni:8 步的 MiniMax H3,运行在我们的 GPU 上完整步数的 MiniMax H3,运行在付费线路上
分辨率最高 768p768p 和 2K
宽高比9:16, 16:9, 1:1更多,包括 21:9
首帧和尾帧noyes
参考图片最多 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 等)。

制作一段免费的 MiniMax H3 视频

注册,创建 API 密钥,发送你的第一个 minimax-h3-free 请求。无需额度;需要更多时,同一个密钥可以运行所有付费模型。