MiniMax

MiniMax H3

minimax-h3-max/text-to-video

Modèle vidéo multimodal unifié, un seul contexte traite simultanément le texte, l'image, la vidéo et l'audio, prend en charge la génération de vidéo à partir de texte, d'image ou de référence ainsi que l'édition par instruction, et peut générer un audio synchronisé

minimax-h3 minimax-h3-max/image-to-video minimax-h3-max/text-to-video

Essayer minimax-h3-max/text-to-video

Entrée

Créations

Voir toutes les créations

Sortie

video

Renseignez les paramètres et générez : les résultats s'afficheront ici.

Tarifs

minimax-h3-max/text-to-video per second

Spécifications	Prix unitaire
480P	$0.072
768P	$0.115
1080P	$0.229

Présentation

minimax-h3-max/text-to-video est une solution de génération de vidéo à partir de texte de MiniMax, dédiée aux scénarios de text-to-video : il suffit de fournir une consigne en langage naturel pour produire un court clip vidéo accompagné d'une piste audio synchronisée. Il prend en charge une durée maximale de 15 secondes, des résolutions allant de 480P à 1080P et six formats d'image, et propose l'extension de prompt ainsi qu'une piste audio cible remplaçable. Il s'adresse aux développeurs qui doivent produire en série des storyboards, des créations publicitaires ou des vidéos verticales courtes, et peut être intégré aux flux de production via l'interface unifiée de HiAPI.ai.

Points clés

Le prompt décrit directement l'image, l'action et le son — le prompt porte à la fois les descriptions visuelles et sonores ; la vidéo générée intègre une piste audio correspondante, ce qui évite l'étape de post-synchronisation.
Extension du prompt à trois niveaux — prompt_expansion_mode propose les modes disabled, balanced et quality, pour arbitrer selon les besoins entre fidélité à l'intention d'origine et enrichissement des détails.
Durée et formats très variés — la durée est réglable de 0,92 à 15 secondes, et les formats couvrent six proportions de 21:9 à 9:16, ce qui permet de générer en une seule configuration des contenus paysage, carrés ou verticaux.
Piste audio de remplacement — en fournissant target_audio_url, la piste audio de sortie peut être remplacée ; l'audio trop long est tronqué en début de piste, l'audio trop court est complété par du silence, ce qui facilite l'alignement sur une musique existante.

Description des capacités

Text-to-video paramétrable : le rendu est contrôlé par la combinaison de prompt, duration, resolution et aspect_ratio ; les valeurs par défaut sont 768P, 16:9 et 5 secondes, et l'on peut passer à 1080P et à un format vertical selon le canal de diffusion.

Sortie audio synchronisée : la génération de la vidéo produit également un son correspondant, ce qui convient aux contenus courts directement exploitables et réduit le travail de post-production audio.

Extension du prompt : lorsque la consigne est succincte, les modes balanced ou quality permettent au modèle de compléter les détails ; pour reproduire strictement la description d'origine, il faut basculer en mode disabled.

Remplacement de la piste audio et contraintes de durée : en fournissant target_audio_url, on peut intégrer son propre audio, et la durée minimale de la vidéo est alors ajustée à 2 secondes pour éviter qu'une piste trop courte ne se désaligne avec l'image.

Graine aléatoire reproductible : le champ seed permet de fixer une graine aléatoire pour reproduire un même résultat ; une valeur 0 transmise explicitement est bien prise en compte, ce qui facilite le débogage et les comparaisons par lots.

Cas d'usage

Équipes de vidéo courte : générer des maquettes à partir d'une description de storyboard en une phrase — en saisissant le texte du plan et les paramètres de durée et de format, on obtient rapidement un clip avec son, pour la validation des storyboards et la confirmation client.
Publicité : production en série multi-formats — à partir d'un même prompt, on génère en changeant de format (16:9, 9:16, 1:1, etc.) des contenus verticaux et carrés directement diffusables sur les différents canaux.
Créateurs de contenu : génération pilotée par la musique — en fournissant son propre audio comme target_audio_url, on génère des images d'une durée alignée sur la piste, pour des clips rythmés et des contenus musicaux.
Développeurs d'applications : intégration d'une API vidéo programmatique — via l'interface unifiée de HiAPI.ai, appelée par lots avec seed et paramètres, le text-to-video s'intègre aux flux de production de contenu ou d'automatisation marketing.

Limites et conseils de choix

La durée maximale d'une génération est de 15 secondes ; une narration plus longue nécessite une génération par segments puis un assemblage. La résolution maximale est de 1080P ; pour des sorties de plus haute qualité, il convient d'évaluer d'autres solutions. Lorsque l'extension du prompt est activée, le modèle ajoute des détails ; si une reproduction stricte de la description est requise, il est conseillé de la désactiver. Avec un audio personnalisé, la durée minimale de la vidéo est de 2 secondes, et la piste est tronquée ou complétée par du silence : il faut donc contrôler soi-même la longueur des ressources. Pour les scénarios avec une entrée uniquement textuelle nécessitant une image de référence ou le contrôle des première et dernière images, il faut choisir une solution image-to-video de la même série.

Nouveautés

Voir le journal des modifications →

Nouveau modèle Nouveau modèle : minimax-h3 — génération de vidéos natives 2K via POST /v1/tasks, prise en charge de la génération texte-vidéo de 4 à 15 secondes… Jul 31, 2026

Questions fréquentes

Voir toutes les questions →

Quel type de modèle vidéo est MiniMax H3 ?

Il est centré sur le Prompt et peut également intégrer des images de première et dernière frame, ou des images, vidéos et audios de référence ; les différents modes de contrôle doivent être combinés selon le contrat de paramètres en vigueur.
Quelles spécifications de sortie MiniMax H3 prend-il en charge ?

Prise en charge de 4 à 15 secondes, la résolution inclut 2K, les formats d'image incluent 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive.
Peut-on générer de l'audio ou utiliser une référence audio ?

Références image, vidéo et audio en option ; génération audio prise en charge
Comment MiniMax H3 est-il facturé ?

La facturation est basée sur la durée de sortie et le niveau en temps réel ; les différences dues à la résolution, au mode ou aux options audio sont déterminées par le prix affiché sur la page et l'historique des tâches.

Créer une tâche de génération

POST https://api.hiapi.ai/v1/tasks

En-têtes

AuthorizationstringRequis

Clé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API

Content-TypestringOptionnel

Le corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.

Idempotency-KeystringOptionnel

Clé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.

Clé d'idempotence

En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.

Corps

modelstringRequis

Valeur fixe actuelle : minimax-h3-max/text-to-video

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour minimax-h3-max/text-to-video et la route default — voir le tableau des paramètres ci-dessous.

seedintegerOptionnel

Graine aléatoire servant à contrôler le caractère aléatoire des résultats de génération. Si omise, le système la choisit aléatoirement ; pour fixer la graine, il faut la transmettre explicitement, même avec la valeur 0.

promptstringRequisminLength 1maxLength 50000pattern \S

Invite textuelle décrivant l'image, les actions, les mouvements de caméra et le contenu sonore souhaités pour la génération.

durationnumberOptionnelDéfaut: 5min 0.92max 15

Durée de la vidéo générée, de type numérique, valeur par défaut 5.

resolutionstringOptionnelDéfaut: "768P"

Résolution de la vidéo générée, de type chaîne de caractères, valeur par défaut 768P.

Options：480P768P1080P

aspect_ratiostringOptionnelDéfaut: "16:9"

Rapport largeur/hauteur de la vidéo générée, de type chaîne de caractères, valeur par défaut 16:9.

Options：21:916:94:31:13:49:16

target_audio_urlstringOptionnelminLength 1pattern ^https?://[^\s/@]+(?:[/?#][^\s]*)?$

Adresse de l'audio cible, utilisée pour remplacer la piste audio de la vidéo de sortie ; l'audio doit durer au moins 2 secondes et ne pas dépasser 15 Mo, un audio plus long est tronqué au début, un audio plus court est complété par du silence.

prompt_expansion_modestringOptionnelDéfaut: "balanced"

Mode d'extension de l'invite, contrôlant la stratégie d'extension automatique de l'invite saisie, valeur par défaut balanced.

Options：disabledbalancedquality

callbackobjectOptionnel

Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.

Rappels (Webhook)

Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.

urlstringRequis

Obligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.

whenstringOptionnelDéfaut: "final"

Seul final est pris en charge pour l'instant — notifié sur success et fail.

Options：final

storagestringOptionnelDéfaut: "temp"

Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.

Options：temppersistent

Exemples de requête

# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3-max/text-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "768P",
    "aspect_ratio": "16:9",
    "prompt_expansion_mode": "balanced"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "minimax-h3-max/text-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "resolution": "768P",
      "aspect_ratio": "16:9",
      "prompt_expansion_mode": "balanced"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "minimax-h3-max/text-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "resolution": "768P",
          "aspect_ratio": "16:9",
          "prompt_expansion_mode": "balanced"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtenir le détail de la tâche

GET https://api.hiapi.ai/v1/tasks/:id

Champs de réponse

taskIdstringRequis

Identifiant de tâche, toujours préfixé tk-hiapi-.

modelstringRequis

Nom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.

routestringOptionnel

Présent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.

statusstringRequis

Statut de la tâche.

Valeurs de statut

queued En file, pas encore démarrée. handling En cours de traitement. archiving Traitement terminé, préparation des artefacts. success Terminal : terminé, artefacts disponibles (output renvoyé). fail Terminal : échec (error renvoyé). Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.

creatednumberRequis

Date de création de la tâche (secondes Unix).

completednumberRequis

Secondes Unix de l'état terminal ; 0 tant que non terminal.

outputarrayOptionnel

Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).

Array [ object ]

Éléments du tableau

urlstringRequis

URL de l'artefact, téléchargeable directement.

typestringRequis

Valeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.

expireAtnumberRequis

Secondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.

errorobjectOptionnel

Présent uniquement si status == fail.

codestringRequis

Code d'erreur métier.

messagestringRequis

Description de l'erreur.

Exemples de réponse

Succès

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En cours (non terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Échec

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}