MiniMax

MiniMax H3

minimax-h3-max/image-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/image-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/image-to-video per second

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

Présentation

La voie image-vers-vidéo de MiniMax H3 Max s'adresse aux développeurs qui ont besoin de produire des vidéos stables à partir d'une image fixe. Partant de l'image de première frame fournie, elle anime l'action, la caméra et le son de la scène selon le prompt et produit une vidéo dont la durée et la résolution sont ajustables ; elle prend également en charge l'appairage première et dernière frames pour encadrer la transition entre ces deux images. Elle convient à la prévisualisation de storyboards publicitaires, à l'animation d'illustrations et d'images produit, ainsi qu'aux flux de production de courts-métrages nécessitant des transitions maîtrisées, et est appelable via l'interface unifiée de HiAPI.ai avec une facturation à la durée de sortie.

Points clés

Transition contrainte par deux images (première et dernière frames) — il est possible de fournir uniquement la première frame pour générer la suite, ou d'indiquer la première et la dernière frames pour que le modèle réalise l'action et la transition entre les deux.
Durée et résolution ajustables — la durée se règle entre 0,92 et 15 secondes, et la résolution est au choix 480P, 768P ou 1080P, selon les besoins du rendu final.
Remplacement facultatif de la piste audio — l'URL audio cible remplace la piste de sortie ; si l'audio est trop long, son début est conservé, s'il est trop court, il est complété par du silence, ce qui facilite l'alignement d'une voix off ou d'une musique.
Extension du prompt sur trois niveaux — le mode d'extension se décline en désactivé, équilibré et qualité, permettant d'arbitrer entre stricte fidélité à la description d'origine et enrichissement automatique des détails de l'image.

Fonctionnalités

Image-vers-vidéo et contrôle première/dernière frames : l'image de première frame détermine le ratio de l'image et sert de base à la génération vidéo ; si seule la dernière frame est fournie, la composition suit celle-ci ; si les deux frames sont fournies, la transition est contrainte, ce qui convient aux transitions maîtrisées et aux plans de comparaison avant/après.

Paliers de durée et de résolution : une génération prend en charge de 0,92 à 15 secondes et de 480P à 1080P, permettant aux développeurs de choisir un palier d'aperçu ou de livraison selon l'usage du rendu final, et d'éviter le gaspillage lié à un niveau uniformément élevé sur tout le flux.

Injection de piste audio : il suffit de transmettre l'URL audio cible pour remplacer la piste de sortie ; l'audio doit durer au moins 2 secondes et ne pas dépasser 15 Mo, et le modèle le tronque ou le complète par du silence selon la longueur de la vidéo, ce qui évite un second alignement lors du doublage.

Organisation du prompt : le prompt peut contenir jusqu'à 50 000 caractères pour décrire l'image, l'action, la caméra et le son ; le mode d'extension peut être désactivé, équilibré ou qualité, afin de contrôler la fidélité à la description d'origine lors de la génération.

Graine aléatoire fixe : fournir explicitement une graine permet de reproduire le même résultat et, en ajustant finement le prompt pour des expériences comparatives, d'identifier les recettes efficaces lors de générations en lot.

Cas d'usage

Les équipes publicitaires et de storyboard génèrent une prévisualisation à partir d'un visuel principal — téléversez l'image de première frame en précisant l'action et la caméra, puis produisez une vidéo de prévisualisation de 5 à 15 secondes pour les propositions et la validation du rythme avant tournage.
Animation d'illustrations et d'images produit — partez d'une illustration ou d'une image produit, choisissez une sortie en 768P ou 1080P selon le besoin, et obtenez une courte vidéo en boucle directement diffusable.
Enchaînement de plans à transition définie — fournissez à la fois la première et la dernière frames pour que le modèle complète l'étape intermédiaire et produise un segment de transition naturel à intégrer dans la timeline de montage.
Alignement labial sur une voix off ou une musique existante — transmettez l'URL audio cible pour générer un segment doté de la piste correspondante, et obtenez des rushes directement exploitables en post-production.

Limites et conseils de choix

Cette voie n'accepte que la génération image-vers-vidéo et ne prend pas en charge la génération texte-vers-vidéo pure ni les entrées mixtes avec images de référence ; un segment dure au maximum 15 secondes, et une narration plus longue nécessite une génération par segments suivie d'un montage. Lorsqu'un audio cible est transmis, la durée minimale de la vidéo est de 2 secondes et l'audio ne doit pas dépasser 15 Mo. Si l'objectif est une génération purement texte-vers-vidéo ou qu'une entrée de référence multimodale est requise, il convient d'utiliser une autre voie de la même famille ; les scénarios sans besoin de contrôle première/dernière frames ni d'injection de piste audio peuvent aussi opter pour un mode de génération plus léger.

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/image-to-video

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

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

seedintegerOptionnel

Graine aléatoire, entier. Si omise, le système la choisit au hasard ; si 0 est explicitement spécifié, il doit être transmis tel quel, afin de reproduire le résultat de génération.

promptstringRequisminLength 1maxLength 50000pattern \S

Invite textuelle décrivant l'image, l'action, le cadrage et le contenu sonore souhaités.

durationnumberOptionnelDéfaut: 5min 0.92max 15

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

resolutionstringOptionnelDéfaut: "768P"

Résolution de la vidéo de sortie, chaîne de caractères, par défaut 768P.

Options：480P768P1080P

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

Image de dernière image, utilisée pour spécifier l'image de fin de la vidéo ; le rapport d'image suit la première image, et ne suit la dernière image que lorsqu'une dernière image est fournie sans première image.

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

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

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

Image de première image, utilisée pour spécifier l'image de début de la vidéo ; le rapport d'image suit la première image, et ne suit la dernière image que lorsqu'il n'y a qu'une dernière image.

prompt_expansion_modestringOptionnelDéfaut: "balanced"

Mode d'extension de l'invite, chaîne de caractères, 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/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "768P",
    "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/image-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "resolution": "768P",
      "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/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "resolution": "768P",
          "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"
    }
  }
}