API gratuita de MiniMax H3: vídeo con sonido sin coste

Qué es MiniMax H3 Free

minimax-h3-free es MiniMax H3 ejecutado con FastH3 Omni, una versión destilada que renderiza en 8 pasos en lugar del calendario completo. Se ejecuta en una GPU nuestra y no en un proveedor de pago, y por eso podemos regalarlo. Todos los clips tienen sonido generado junto con la imagen: pasos, voces, música, el ambiente.

Es un id de modelo distinto del minimax-h3 de pago. Nada cambia en el modelo de pago, y eliges en cada solicitud a cuál llamar.

Cómo funciona la cola gratuita

Una GPU hace un clip a la vez, así que los trabajos gratuitos esperan su turno:

• Tu trabajo se acepta al instante. POST /v1/generations responde 202 con un id, como con cualquier modelo, y el trabajo muestra queued hasta que la GPU tenga hueco.
• Los turnos van por cuenta. Cuando hay mucha gente esperando, la GPU toma el siguiente trabajo de la siguiente cuenta en la fila, así que una cuenta que envía una ráfaga no hace retroceder a todas las demás.
• Diez a la vez por cuenta. Puedes tener hasta 10 trabajos gratuitos en cola o en ejecución. Un undécimo se rechaza con 429 concurrency_limit; envíalo de nuevo cuando termine uno.
• Espera hasta tres horas. Un trabajo que siga esperando pasado ese tiempo falla con model_busy, sin coste.

Cuando un trabajo llega a la GPU, se renderiza en unos 12 segundos más 10 segundos por cada segundo de clip a 768p, así que un clip de 5 segundos tarda aproximadamente un minuto. Consulta el estado cada 10 segundos más o menos; la documentación cubre todos los estados que puede mostrar un trabajo.

Genera un clip gratuito a partir de texto

La solicitud es la misma que para cualquier modelo de Revana. No hay max_cost_usd que configurar ni crédito que comprar antes.

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"

Empezar desde una imagen

Envía una imagen inicial como image_url y el clip empieza con ella, conservando sus personas, objetos y entorno. Añade hasta tres más como image_urls (cuatro en total) y nómbralas en el prompt entre corchetes angulares, como Picture 1, Picture 2 y así sucesivamente. Las imágenes son PNG, JPEG, WebP o GIF en enlaces https públicos; si solo tienes un archivo, súbelo primero con 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 gratuito o de pago?

Usa el modelo gratuito para probar ideas, esbozar storyboards y hacer clips para redes sociales en los que 768p es suficiente. Usa el de pago cuando necesites 2K, un encuadre más ancho, fotogramas inicial y final, más imágenes de referencia o un clip que empiece de inmediato.

La gama completa está en la guía de Hailuo y MiniMax, y la guía de la API de vídeo más barata cubre el precio más bajo de cada modelo de pago. Todos los modelos están en la página de modelos, los paquetes de créditos en la página de precios, y puedes obtener una clave de API para ejecutar los ejemplos.