Génération d'images GPT-Image-2

• Modèle : gpt-image-2
• Point de terminaison : POST https://apimaster.ai/v1/images/generations
• Mode : Asynchrone — renvoie task_id, puis interroger la tâche
• Fonctionnalités : Texte vers image ; image vers image avec jusqu'à 16 images de référence (mix URL + base64)

Authentification

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Paramètres du corps

Champ	Type	Requis	Remarques
model	string	oui	gpt-image-2
prompt	string	oui	Description de la scène ; modération de sécurité applicable
n	integer	non	1 uniquement (numérique, sans guillemets)
size	string	non	Rapport d'aspect, par défaut 1:1
resolution	string	non	1k / 2k / 4k, par défaut 1k
image_urls	array	non	Images de référence → image vers image
official_fallback	boolean	non	Repli vers le canal officiel, par défaut false

Valeurs de size

auto, 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21, ou des chaînes de pixels comme 3840x2160.

résolution (exemples de pixels)

size	1k	2k	4k
1:1	1024×1024	2048×2048	2880×2880
16:9	1536×864	2048×1152	3840×2160

Les 15 ratios supportent la 4K.

image_urls

• Maximum 16 images
• Les URLs publiques et les URI de données base64 peuvent être mélangées
• Omettre size pour suivre la résolution d'entrée ; définir size pour forcer le rapport d'aspect de sortie

Exemples

Texte vers image minimal

{
  "model": "gpt-image-2",
  "prompt": "An orange cat on a windowsill at sunset, watercolor"
}

16:9 en 2K

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a corgi astronaut on the moon, cinematic",
    "size": "16:9",
    "resolution": "2k"
  }'

Réponse de soumission

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA" }]
}

HTTP	Signification
400	Paramètres invalides
401	Clé API incorrecte
402	Solde insuffisant
429	Limite de débit atteinte

Interroger le résultat de la tâche

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

URL de l'image : data.result.images[0].url[0]

statut	Signification
submitted	En file d'attente
processing	En cours
completed	Prêt
failed	Voir l'erreur

Interroger après 10–20s, toutes les 3–5s. Par lot : POST https://apimaster.ai/v1/tasks/batch avec {"task_ids":[...]}.

Remarques

• Asynchrone uniquement — pas d'URL d'image synchrone dans la réponse de création.
• Préférer size pour le rapport d'aspect ; éviter de répéter le rapport dans prompt.
• Facturation par niveau de résolution ; voir la console pour votre compte.

Comparer avec le canal officiel.