Guide de démarrage de MiniMax H3 Image : génération d'images à partir de texte, édition avec références multiples, paramètres et tarifs

MiniMax H3 Image est un modèle d'image de MiniMax, disponible sur HiAPI via deux ID d'appel : minimax-h3-image/text-to-image (génération à partir de texte) et minimax-h3-image/image-to-image (génération ou édition à partir de 1 à 16 images de référence). Cet article explique clairement comment choisir entre les deux ID, comment renseigner les paramètres, comment calculer le coût, ainsi que les détails à surveiller lors de l'appel.

Comment choisir entre les deux ID

• Vous n'avez qu'une description textuelle : utilisez text-to-image, seul prompt est obligatoire (5000 caractères maximum).
• Vous avez des images à utiliser comme référence : utilisez image-to-image, image_urls est alors également obligatoire, de 1 à 16 images. Vous pouvez changer le décor d'une photo de produit, redessiner une photo dans un style illustration ou peinture à l'huile, ou encore fournir plusieurs images de référence à la fois.
• Les deux ID ont le même prix de génération ; le mode image-to-image ajoute un supplément selon le nombre d'images de référence, voir la section « Tarifs » ci-dessous.

Paramètres

• resolution : 1K / 2K / 4K, valeur par défaut 2K. Par exemple, 2K en 1:1 produit 2048×2048, 1K en 9:16 produit 768×1360, 4K en 16:9 produit 5472×3072.
• aspect_ratio : auto, 1:1, 5:4, 4:5, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9. En text-to-image, la valeur par défaut est 1:1 ; en image-to-image, la valeur par défaut est auto, le modèle choisit lui-même le ratio en fonction du prompt et des images de référence, sans forcément suivre la première image de référence — pour imposer un cadrage, renseignez explicitement le ratio.
• output_format : jpeg (par défaut) ou png. Le PNG est bien plus volumineux, un PNG 4K peut atteindre 30 Mo ; sauf besoin particulier, utilisez jpeg.
• seed : facultatif, de 0 à 2147483647, à fixer pour reproduire la même image.
• Chaque requête génère 1 image ; les dimensions personnalisées, le fond transparent et le repaint local avec masque ne sont pas pris en charge.

Exemple d'appel

Soumettre une tâche :

curl https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-image/image-to-image",
    "input": {
      "prompt": "Placez le flacon de sérum sur un socle en pierre pâle, lumière latérale douce, photo produit e-commerce épurée",
      "image_urls": ["https://example.com/bottle.png"],
      "resolution": "2K",
      "aspect_ratio": "3:4"
    }
  }'

Après réception de data.taskId, interrogez GET https://api.hiapi.ai/v1/tasks/<taskId> en boucle. Lorsque status passe à success, l'adresse de l'image se trouve dans data.output[0].url. Une image 2K est généralement produite en 30 à 40 secondes. Le lien du résultat a une durée de validité (champ expireAt) ; pour une conservation à long terme, téléchargez et stockez le fichier vous-même.

Tarifs

• 1K, 2K : 0,0129 $ par image.
• 4K : 0,0393 $ par image.
• En image-to-image, chaque image de référence ajoute 0,0036 $. Par exemple, 2K avec 3 images de référence : 0,0129 + 3 × 0,0036 = 0,0237 $.
• Seules les tâches ayant généré une image avec succès sont facturées ; en cas d'échec, la tâche est intégralement remboursée.

Comment rédiger le prompt

• Rédigez clairement dans l'ordre « sujet + scène + lumière + style + composition ».
• En image-to-image, précisez ce qui doit être conservé et ce qui doit être modifié, par exemple « conservez les traits du visage et la posture de la personne, remplacez l'arrière-plan par des aplats gris chauds, et appliquez un rendu général en coups de pinceau à l'huile ».
• Testez d'abord la composition en 1K ou 2K, puis générez en 4K une fois le résultat validé : le prix unitaire du 4K est environ 3 fois celui du 2K.