API MiniMax H3 gratuite : de la vidéo avec son, sans frais

Ce qu'est MiniMax H3 Free

minimax-h3-free est MiniMax H3 exécuté via FastH3 Omni, une version distillée qui effectue le rendu en 8 étapes au lieu du calendrier complet. Il tourne sur un GPU qui nous appartient plutôt que chez un fournisseur payant, ce qui explique que nous puissions l'offrir. Chaque clip a un son généré avec l'image : pas, voix, musique, ambiance de la pièce.

C'est un identifiant de modèle distinct de minimax-h3 payant. Rien ne change pour le modèle payant, et vous choisissez à chaque requête lequel appeler.

Comment fonctionne la file d'attente gratuite

Un GPU ne produit qu'un clip à la fois : les tâches gratuites passent donc à tour de rôle :

• Votre tâche est acceptée immédiatement. POST /v1/generations répond 202 avec un identifiant, comme pour n'importe quel modèle, et la tâche affiche queued jusqu'à ce que le GPU ait de la place.
• Les tours se font par compte. Quand beaucoup de monde attend, le GPU prend la tâche suivante du compte suivant dans la file : un compte qui envoie une rafale ne fait donc pas reculer tous les autres.
• Dix à la fois par compte. Vous pouvez avoir jusqu'à 10 tâches gratuites en file d'attente ou en cours. Une onzième est refusée avec 429 concurrency_limit ; renvoyez-la quand l'une se termine.
• Elle attend jusqu'à trois heures. Une tâche qui attend encore après ce délai échoue avec model_busy, sans frais.

Une fois qu'une tâche arrive sur le GPU, elle est rendue en environ 12 secondes plus 10 secondes par seconde de clip en 768p : un clip de 5 secondes prend donc environ une minute. Interrogez toutes les 10 secondes environ ; la documentation décrit tous les statuts qu'une tâche peut afficher.

Générer un clip gratuit à partir d'un texte

La requête est la même que pour tous les modèles de Revana. Il n'y a aucun max_cost_usd à définir et aucun crédit à acheter d'abord.

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"

Partir d'une image

Envoyez une image de départ dans image_url et le clip s'ouvre sur elle, en conservant ses personnages, ses objets et son décor. Ajoutez-en jusqu'à trois autres dans image_urls (quatre au total) et nommez-les dans le prompt Picture 1, Picture 2, etc. (entre chevrons). Les images sont des PNG, JPEG, WebP ou GIF à des liens https publics ; si vous n'avez qu'un fichier, téléversez-le d'abord avec 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 gratuit ou payant ?

Utilisez le modèle gratuit pour essayer des idées, faire des brouillons de storyboards et produire des clips pour les réseaux sociaux où le 768p suffit. Utilisez le modèle payant quand vous avez besoin de 2K, d'un cadre plus large, de première et dernière images, de plus d'images de référence ou d'un clip qui démarre tout de suite.

La gamme complète se trouve dans le guide Hailuo et MiniMax, et le guide de l'API vidéo la moins chère donne le prix le plus bas de chaque modèle payant. Tous les modèles sont sur la page des modèles, les packs de crédits sur la page des tarifs, et vous pouvez obtenir une clé API pour exécuter les exemples.