MiniMax

MiniMax H3 Image

minimax-h3-image/text-to-image

Modèle d'image MiniMax : la génération texte-image et l'édition à partir de 1 à 16 images de référence partagent un même ensemble de capacités, avec une sortie jusqu'à 4K, la prise en charge de dix formats d'image et du ratio automatique, idéal pour la conception conceptuelle, la création visuelle commerciale et les créations multi-styles

minimax-h3-image/image-to-image minimax-h3-image/text-to-image

Essayer minimax-h3-image/text-to-image

Entrée

Créations

Voir toutes les créations

Sortie

image

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

Tarifs

minimax-h3-image/text-to-image per image

Spécifications	Prix unitaire
1K	$0.0129
2K	$0.0129
4K	$0.0393

Présentation

Il s'agit d'un modèle qui génère des images statiques à partir d'une description textuelle. Il suffit de saisir une invite pour obtenir une image conforme à la description, tout en contrôlant le niveau de résolution, le format d'image et le format de sortie. Si nécessaire, vous pouvez également fixer une graine aléatoire pour rendre reproductibles les résultats obtenus avec la même invite et les mêmes paramètres. Il s'adresse aux designers, créateurs de contenu et développeurs qui souhaitent concrétiser rapidement leurs idées, et convient à la création d'images de concept, d'ambiances de scène et de divers supports visuels.

Points clés

Extension automatique de l'invite — l'invite soumise est automatiquement enrichie de détails supplémentaires, ce qui favorise un rendu visuel plus riche.
Plusieurs niveaux de résolution au choix — la résolution de sortie peut être choisie parmi trois niveaux : 1K, 2K et 4K, correspondant à environ 1, 4 et 16 mégapixels.
Prise en charge de nombreux formats d'image — plusieurs ratios intégrés, de 1:1 à 21:9, ainsi qu'une sélection automatique, pour s'adapter à différents besoins de mise en page.
Graine fixe reproductible — définissez une graine entière entre 0 et 2147483647 pour reproduire les résultats obtenus avec la même invite et les mêmes paramètres.

Description des capacités

Génération d'images à partir de texte : saisissez une invite décrivant l'image souhaitée ; le modèle génère une image statique correspondante. L'invite doit contenir au minimum 1 caractère et au maximum 5000 caractères.

Contrôle du niveau de résolution : la résolution de sortie peut être choisie parmi trois niveaux : 1K, 2K et 4K, correspondant respectivement à environ 1, 4 et 16 mégapixels ; la valeur par défaut est 2K.

Contrôle du format d'image : prise en charge des ratios 1:1, 5:4, 4:5, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9 ainsi que du ratio automatique ; la valeur par défaut est 1:1.

Choix du format de sortie : sortie possible au format JPEG ou PNG ; les fichiers PNG sont plus volumineux, environ 12 Mo en 2K et environ 30 Mo en 4K.

Graine aléatoire fixe : une graine entière de 0 à 2147483647 est disponible pour reproduire les résultats avec la même invite et les mêmes paramètres ; si elle n'est pas définie, elle est générée aléatoirement.

Cas d'usage

Concepteurs dessinant des personnages et des scènes — saisissez une description textuelle d'un personnage ou d'une scène pour générer une image de concept stylisée, destinée aux propositions préliminaires et au développement visuel.
Créateurs de contenu réalisant des illustrations — rédigez une invite en fonction du thème d'un article ou d'une vidéo pour générer une image adaptée à la mise en page, directement utilisable pour la publication du contenu.
Production de supports visuels commerciaux — choisissez le niveau 4K et un format d'image élevé pour générer des supports à haute résolution destinés à la publicité ou à la présentation.
Génération d'images en lot par les développeurs — combinez graines fixes et paramètres pour générer en lot des ressources d'images reproductibles, à intégrer dans un pipeline de design ou de contenu.

Limites et conseils de sélection

L'invite est obligatoire, limitée à 5000 caractères, et ne peut pas contenir uniquement des espaces. Le niveau de résolution, le format d'image et le format de sortie doivent être choisis parmi les valeurs d'énumération ; aucune valeur personnalisée n'est prise en charge. La graine est limitée à un entier de 0 à 2147483647. Le résultat généré est une image statique, une image par requête.

Nouveautés

Voir le journal des modifications →

Nouveau modèle MiniMax H3 Image est disponible : génération d'images à partir de texte et édition à partir de plusieurs images de référence Nov 12, 2026

Questions fréquentes

Voir toutes les questions →

Combien d'images de référence peut-on fournir au maximum ?

La génération d'image à partir d'image accepte au maximum 16 images de référence par requête, et au minimum 1, aux formats JPG, PNG ou WEBP, avec un côté de 128 à 8192 px et un poids ne dépassant pas 20 Mo par image. Chaque image de référence est facturée 0,0036 $ supplémentaire ; par exemple, en 2K avec 3 images de référence, le total est de 0,0129 $ + 3 × 0,0036 $ = 0,0237 $. Lors de la rédaction du prompt, désignez chaque image par un numéro dans l'ordre de transmission, comme Picture 1, Picture 2, afin que le modèle puisse correctement les associer aux objets à modifier ou à combiner.
Comment définir la taille de sortie et jusqu'à quelle taille peut-on aller ?

La résolution propose trois paliers : 1K, 2K et 4K, soit environ 1 MP, 4 MP et 16 MP, avec 2K par défaut. Le rapport d'image peut être auto ou 1:1, 5:4, 4:5, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9 ; en mode auto, le modèle décide lui-même en combinant le prompt et l'image de référence ; pour une composition fixe, il faut le spécifier explicitement.
Comment rédiger le prompt pour préserver le visage du personnage ?

Organisez votre prompt dans cet ordre : « décrivez d'abord le sujet à conserver, puis les éléments à modifier, et enfin référencez les images par leur numéro » : ① commencez par une ou deux phrases décrivant les traits fixes du sujet, comme la coiffure, les vêtements, le jeu de couleurs et les détails emblématiques ; ② précisez ensuite la scène cible, la pose, l'angle de caméra et l'éclairage ; ③ lorsque vous devez faire référence à une image de référence, écrivez « le personnage de Picture 1 », en numérotant plusieurs images selon leur ordre de transmission. Le prompt est limité à 5000 caractères ; il est plus efficace d'intégrer les détails dans le texte plutôt que d'empiler les adjectifs.
Comment réaliser des visuels de référence sous plusieurs angles d'un même personnage ?

Utilisez d'abord une image de référence avec un sujet net et sans obstruction comme Picture 1, fixez la description des caractéristiques du personnage dans le prompt, puis générez les images une par une en ne modifiant que la description de l'angle ou de la pose, par exemple vue de face, de profil, de dos, en buste et en pied, avec un ratio fixé à 3:4 ou 1:1. Conserver le même seed pour chaque image aide à réduire les variations aléatoires ; la cohérence de style d'une série d'images repose principalement sur l'image de référence et une description fixe du sujet.

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

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

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

seedintegerOptionnelmin 0max 2147483647

Graine aléatoire fixe pour rendre les résultats reproductibles ; valeur entière, une graine aléatoire est utilisée si omise.

promptstringRequisminLength 1maxLength 5000pattern \S

Prompt de description d'image, longueur de 1 à 5000 caractères ; le prompt est automatiquement étendu pour offrir des détails plus riches.

resolutionstringOptionnelDéfaut: "2K"

Niveau de résolution de sortie, 1K ≈ 1 MP, 2K ≈ 4 MP, 4K ≈ 16 MP ; par défaut 2K.

Options：1K2K4K

aspect_ratiostringOptionnelDéfaut: "1:1"

Rapport largeur-hauteur de sortie ; lorsqu'il est défini sur auto, le modèle choisit lui-même, par défaut 1:1.

Options：auto1:15:44:54:33:43:22:3

Tout afficher (3)Afficher moins

16:99:1621:9

output_formatstringOptionnelDéfaut: "jpeg"

Format de l'image de sortie, par défaut jpeg ; les fichiers PNG sont nettement plus volumineux (environ 12 Mo en 2K, environ 30 Mo en 4K).

Options：jpegpng

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-image/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "2K",
    "aspect_ratio": "1:1",
    "output_format": "jpeg"
  }
}'

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-image/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "2K",
      "aspect_ratio": "1:1",
      "output_format": "jpeg"
    }
  }),
});
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-image/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "2K",
          "aspect_ratio": "1:1",
          "output_format": "jpeg"
        }
    },
)
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"
    }
  }
}