MiniMax H3
hailuo/minimax-h3MiniMax H3 (Hailuo 03) est un modèle unifié de génération vidéo multimodale qui transforme textes, images, vidéos et références audio en vidéos 2K soignées avec son stéréo natif. Créez des scènes originales, animez des images fixes, modifiez des séquences existantes, le tout via une seule API MiniMax H3.
Aperçu
MiniMax H3 (Hailuo 03) est un modèle unifié de génération vidéo multimodale qui transforme textes, images, vidéos et références audio en vidéos 2K soignées avec son stéréo natif. Créez des scènes originales, animez des images fixes, modifiez des séquences existantes, le tout via une seule API MiniMax H3.
Authentification
Toutes les requêtes API nécessitent une clé API valide transmise via l'en-tête Authorization avec le schéma Bearer.
Démarrage rapide
Identifiants
Définissez la variable d'environnement RUNBASE_API_KEY.
export RUNBASE_API_KEY=your-api-keyCréer une exécution
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo/minimax-h3",
"input": {
"prompt": "A cinematic product photo of a ceramic lamp"
}
}'Exécutions
Les exécutions sont traitées de manière asynchrone. Soumettez une requête, puis interrogez le résultat.
Créer une exécution
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo/minimax-h3",
"input": { "prompt": "A cinematic product photo of a ceramic lamp" }
}'Obtenir le statut d'exécution
curl -s https://runbase.net/api/v1/runs/RUN_ID \
-H "Authorization: Bearer $RUNBASE_API_KEY"Obtenir le résultat
Interrogez l'endpoint de statut jusqu'à ce que status soit "succeeded", puis lisez output.urls dans la réponse.
Schéma d'entrée
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| prompt | string | Requis | PromptJusqu'à 7000 caractères |
| aspect_ratio | string | Optionnel | Aspect ratioOptions : 16:99:161:14:33:421:9Par défaut : 16:9 |
| resolution | string | Optionnel | 2K requires at least one reference image; text-only generation supports 768p only.Options : 768p2kPar défaut : 768p |
| duration | number | Optionnel | Duration (seconds)Plage : 4–15Par défaut : 5 |
| image_urls | string[] | Optionnel | Reference imagesJusqu'à 5 images |
Schéma de sortie
| Champ | Type | Description |
|---|---|---|
| urls | string[] | URLs des résultats générés |
Erreurs
L'API utilise les codes de statut HTTP standard pour indiquer le succès ou l'échec.
| Code de statut | Description |
|---|---|
| 400 | Invalid request - missing or malformed parameters |
| 401 | Authentication failed - missing or invalid API key |
| 402 | Insufficient credits |
| 403 | Forbidden - IP not allowed, account banned, or API key credit limit exceeded |
| 404 | Run not found |
| 429 | Rate limit exceeded |
| 500 | Internal server error |

