Бесплатный API MiniMax H3: видео со звуком бесплатно

Что такое MiniMax H3 Free

minimax-h3-free — это MiniMax H3, запущенный через FastH3 Omni, дистиллированную версию, которая рендерит за 8 шагов вместо полного расписания. Он работает на нашем GPU, а не у платного провайдера, поэтому мы можем отдавать его бесплатно. В каждом клипе есть звук, созданный вместе с картинкой: шаги, голоса, музыка, окружение.

Это отдельный id модели, не платный minimax-h3. С платной моделью ничего не меняется, а какую вызывать — вы выбираете в каждом запросе.

Как работает бесплатная очередь

Один GPU делает один клип за раз, поэтому бесплатные задачи идут по очереди:

• Ваша задача принимается сразу. POST /v1/generations отвечает 202 с id, как для любой модели, и задача показывает queued, пока на GPU не появится место.
• Очередь идёт по аккаунтам. Когда ждёт много людей, GPU берёт следующую задачу у следующего по очереди аккаунта, так что один аккаунт, отправивший пачку, не отодвигает всех остальных.
• Десять одновременно на аккаунт. У вас может быть до 10 бесплатных задач в очереди или в работе. Одиннадцатая отклоняется с 429 concurrency_limit; отправьте её снова, когда одна завершится.
• Ожидание — до трёх часов. Задача, которая всё ещё ждёт по их истечении, завершается ошибкой model_busy без списания.

Когда задача попадает на GPU, она рендерится примерно 12 секунд плюс 10 секунд на секунду клипа в 768p, так что 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"])

Бесплатный или платный MiniMax H3?

Используйте бесплатную модель, чтобы пробовать идеи, делать черновые раскадровки и клипы для соцсетей, где хватает 768p. Платную берите, когда нужны 2K, более широкий кадр, первый и последний кадры, больше референсных картинок или клип, который стартует сразу.

Полная линейка описана в руководстве по Hailuo и MiniMax, а руководство по самому дешёвому API для видео охватывает минимальную цену каждой платной модели. Все модели есть на странице моделей, пакеты кредитов — на странице цен, а чтобы запустить примеры, получите API-ключ.