MiniMax H3 Image

Exemple rapide

Envoie une requête d’image, conserve l’id renvoyé et interroge son état jusqu’à ce que la tâche soit completed ou failed. Cette API utilise des tâches asynchrones et des résultats sous forme d’URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"minimax-h3-image","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'

Point de terminaison et en-têtes

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

Conserve la clé sur ton serveur. Une réponse HTTP réussie confirme la réception d’une tâche ; elle ne signifie pas que son image est prête.

Paramètres

Il y a 13 champs acceptés. Seuls model et prompt sont obligatoires. Omets les champs facultatifs pour utiliser les valeurs par défaut ; aucun champ n’accepte null. Le Playground propose le modèle fixe et dix entrées modifiables. Le format de réponse URL et la livraison des tâches sans streaming sont fixes.

Dépendances de taille et de prompt

Une size explicite doit contenir des dimensions entières positives dont la surface est comprise entre 655 360 et 20 000 000 de pixels, bornes incluses. La largeur divisée par la hauteur doit être comprise entre 1/3 et 3. Par exemple, 2048x1152 est valide. Lorsque tu utilises des dimensions explicites, omets à la fois aspect_ratio et area, même si leur valeur serait auto.

Si la taille est omise ou définie sur auto, utilise aspect_ratio et area ensemble. La surface est une taille cible ; vérifie le fichier livré pour connaître ses dimensions exactes. Elle ne représente pas un prix fixe par image.

Définir disable_prompt_enhanced: true nécessite une taille explicite en pixels ou un rapport d’aspect fixe. Lorsque l’amélioration est désactivée, le modèle lit environ les 4 096 premiers tokens du prompt. La limite d’envoi de 32 000 caractères reste applicable. La modification améliore toujours les prompts, donc true est refusé lorsque images est présent.

Aucun champ de masque, de seed, de style, de qualité, de prompt négatif, d’arrière-plan ou de résolution distincte n’est accepté. Les paramètres inconnus renvoient une erreur avant l’envoi. Cette API ne propose ni streaming, ni images base64, ni sortie WebP.

Images de référence

Utilise des URL HTTP(S) accessibles publiquement, sans identifiants intégrés. Chaque image doit être au format JPEG, PNG, WebP, HEIC ou HEIF ; faire au maximum 64 MiB ; avoir 128–8 192 pixels par côté ; et un rapport entre le côté long et le côté court d’au maximum 4. Maintiens le corps JSON à 64 MiB ou moins. Les fichiers image sont référencés par URL ; leurs octets ne sont pas intégrés au corps JSON.

Attribue un objectif clair à chaque référence et décris ce qui doit rester inchangé. L’ordre du tableau identifie <Picture 1>, <Picture 2> et ainsi de suite.

{
  "model": "minimax-h3-image",
  "prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
  "images": [
    {"image_url": "https://example.com/product.jpg"},
    {"image_url": "https://example.com/setting.jpg"}
  ],
  "aspect_ratio": "3:2",
  "area": "2K",
  "n": 1,
  "output_format": "png"
}

Remplace les URL d’exemple par tes propres fichiers image accessibles.

Facturation

La facturation comprend trois catégories de tokens : entrée de texte, entrée d’image et sortie d’image. Multiplie l’utilisation réelle de chaque catégorie par son tarif actuel. Le nombre de résultats, les dimensions des images et les images de référence influencent l’utilisation ; les noms de résolution ne définissent pas un montant de facture fixe. Les requêtes échouées ne sont pas facturées. Consulte les tarifs actuels.

Réponse de tâche et interrogation de l’état

Une requête acceptée renvoie une tâche asynchrone :

{"id":"task_example","model":"minimax-h3-image","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Une réponse terminée contient des URL d’images dans output.data. Chaque image livrée inclut sa size et peut inclure revised_prompt (la description améliorée). output.created est l’heure de création en secondes Unix, et output.output_format identifie le format livré. output.usage expose les nombres de tokens d’entrée de texte, d’entrée d’image et de sortie d’image ainsi que le nombre de generated_images livrées. Les URL et les ID ci-dessous sont donnés à titre d’exemple :

{
  "id": "task_example",
  "model": "minimax-h3-image",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

Interroge l’état toutes les 10–20 secondes. Un délai d’attente dépassé côté client ne signifie pas que la tâche a échoué : conserve son ID et poursuis les interrogations au lieu d’envoyer une requête en double. Les réponses publiques ne contiennent ni soldes de compte ni coûts.

Erreurs

Les erreurs HTTP utilisent {"error":{"code":integer,"message":string}}. Une tâche échouée a status: "failed" et une erreur. Corrige les paramètres invalides avant un nouvel envoi. Consulte le répertoire d’erreurs partagé et le cycle de vie des tâches.

Pages associées

• Playground et tarifs de MiniMax H3 Image
• MiniMax H3 Image Highspeed