MiniMax H3 Max Turbo

MiniMax H3 Max Turbo génère de courtes vidéos à partir de texte ou d’images clés. Utilisez l’ID de modèle minimax-h3-max-turbo, conservez l’identifiant de tâche renvoyé et interrogez-la pour obtenir la vidéo terminée. Cette page décrit l’interface native à tableau content proposée sur SeedRouter.

ID de modèle

Consultez la page du modèle pour les prix actuels.

Exemple rapide

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max-turbo",
    "content": [
      {"type": "text", "text": "A small sailboat glides across a calm turquoise bay at sunrise, seagulls in the distance, the sound of water and wind. No text, no logos."}
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

Point de terminaison

POST https://api.seedrouter.ai/v1/videos/generations

La réponse est une tâche ({"id": "task_...", "status": "processing"}), pas la vidéo terminée. Interrogez GET /v1/tasks/{task_id} pour obtenir le résultat. Conservez les clés API dans du code côté serveur.

Paramètres

Le schéma est strict : les champs inconnus sont rejetés, pas ignorés. callback_url n’est pas disponible ; interrogez plutôt la tâche. extra est un objet strict facultatif contenant uniquement prompt_expansion_mode. Tous les champs refusent null ; omettez plutôt les champs facultatifs.

Éléments de content

Exactement un élément texte non vide est obligatoire. Une image seule sans rôle est considérée comme la première image. Au plus une première et une dernière image sont acceptées ; une dernière image exige une première image. Images, vidéo et audio de référence ne sont pas pris en charge.

Modes

Les éléments de content déterminent le mode ; aucun champ mode n’est envoyé.

{
  "model": "minimax-h3-max-turbo",
  "content": [
    {"type":"text","text":"Slowly move closer to the ceramic bowl. Keep the glaze and window lighting consistent."},
    {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
  ],
  "resolution": "480P",
  "duration": 5,
  "ratio": "adaptive",
  "extra": {"prompt_expansion_mode":"balanced"}
}

Images clés

Utilisez des URL HTTP(S) publiques sans identifiants intégrés. Base64 et les ID mm_file:// ne sont pas acceptés. Les images peuvent être en JPG, JPEG, PNG, WebP, HEIC ou HEIF, de 30 Mo maximum chacune, avec des côtés de 256 à 5760 pixels et un rapport largeur/hauteur entre 0,4 et 2,5. L’entrée est vérifiée avant la génération. Pour deux images clés, utilisez des compositions et des formats compatibles.

Filtre de contenu

content_filter vaut true sauf si vous le définissez. Avec le filtre activé, la requête, son texte et ses médias, est vérifiée avant la génération. Une requête signalée échoue avec le code 60001 et n'est pas facturée. Réglez content_filter sur false pour ignorer la vérification ; le Playground du site le laisse toujours activé.

Facteurs de coût

La section prix du modèle affiche les tarifs actuels. Turbo n’a qu’un poste de coût : les secondes de sortie à la résolution choisie. Les images de début et de fin ainsi que l’extension du prompt n’ont aucuns frais distincts.

cost = reported output seconds × output-second rate for the resolution

L’estimation utilise les secondes entières demandées. La facture finale utilise les secondes de sortie déclarées par la tâche terminée au tarif enregistré pour la requête. Si aucune donnée d’utilisation valide n’est disponible, l’estimation acceptée s’applique. La durée du conteneur média peut différer légèrement des secondes facturées. Consultez les coûts dans l’historique d’utilisation de votre compte ; les réponses publiques des tâches n’incluent pas les frais. Les tâches échouées ne sont pas facturées.

Schéma de sortie

L'envoi renvoie la tâche :

{"id": "task_...", "model": "minimax-h3-max-turbo", "status": "processing", "created_at": 1789689600}

Récupérer la tâche

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Interrogez toutes les 10 à 20 secondes jusqu'à ce que status vaille completed ou failed. Un dépassement de délai réseau pendant l'interrogation ne signifie pas que la génération a échoué : conservez l'identifiant de tâche et reprenez la vérification. Ne créez pas une autre tâche pour vérifier l'avancement.

Tâche terminée

{
  "id": "task_...",
  "model": "minimax-h3-max-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689740,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 5
  }
}

ratio est le format dans lequel le clip a été créé, y compris celui choisi pour adaptive. La tâche contient la résolution, le format et la durée réels lorsqu’ils sont déclarés. Le JSON ci-dessus illustre la structure de réponse ; ce n’est pas un résultat de génération mesuré.

Erreurs

Les requêtes rejetées avant la création d'une tâche renvoient une erreur HTTP avec un objet error et ne sont pas facturées. Une tâche qui échoue après acceptation renvoie HTTP 200 lorsqu'on l'interroge, avec status: "failed" et un objet error.

Voir le catalogue d'erreurs commun pour les codes, les statuts HTTP et les conseils de reprise.

{
  "id": "task_...",
  "model": "minimax-h3-max-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

Si l'envoi lui-même dépasse le délai, vérifiez vos tâches avant de renvoyer : la première requête a peut-être été acceptée.

Conseils

• Décrivez un sujet, une action, un mouvement de caméra et un éclairage par plan.
• Utilisez 480P pour une ébauche et 768P pour plus de détails. Chaque nouvelle génération est une requête payante distincte.
• Fournissez une première image pour définir la composition de départ ; ajoutez une dernière image uniquement si vous fournissez aussi la première.
• Utilisez extra.prompt_expansion_mode pour choisir disabled, balanced ou quality ; l’omission conserve balanced.
• Examinez le clip complet et son audio avant publication. Un prompt ne garantit pas une géométrie de produit ou des inscriptions exactes.

Ressources liées

• Playground et prix MiniMax H3 Max Turbo
• Télécharger OpenAPI
• Markdown à copier

Portée du contrat

Cette interface utilise le format MiniMax à tableau content avec des ID de modèle SeedRouter, des tâches asynchrones, des images uniquement par URL et des résultats hébergés. Les callbacks et l’annulation sont indisponibles. content_filter est un contrôle d’entrée SeedRouter, pas un paramètre MiniMax.

L’interface distincte hébergée par fal a d’autres champs et limites ; ses réglages 1080P, de durée fractionnaire, d’audio cible et de références ordonnées ne s’appliquent pas ici. Cette interface n’accepte pas les réglages de seed ou de filigrane. Consultez le guide comparatif pour cette distinction et les sources liées.