Skip to main content
POST

Authentification et en-têtes

string
requis
Les endpoints de génération et de consultation des tâches utilisent une API Key de la plateforme pour l’authentification Bearer Token. Obtenez une clé sur la page de gestion des API Key.
Pour consulter une tâche, utilisez une API Key appartenant au même utilisateur de la plateforme.
string
requis
Utilisez application/json pour l’envoi. La génération à partir de texte comme celle à partir d’images utilise un corps de requête JSON.

Choix de la version

Paramètres de la requête

string
requis
Valeur fixe : gpt-image-2.5-ext.
string
défaut:"flare"
Version du modèle. Valeurs possibles : flare, sunburst.
string
requis
Prompt de génération ou de retouche d’image. Il ne doit pas être vide après suppression des espaces en début et en fin.Pour la génération à partir d’images, décrivez les éléments à conserver et ceux à modifier dans les références.
string
défaut:"1K"
Niveau de résolution de sortie. Valeurs possibles : 1K, 2K, 4K.
string
défaut:"auto"
Rapport d’aspect de sortie. Choisissez auto ou l’un des 10 rapports suivants :1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9.
integer
défaut:"1"
Nombre d’images à générer par requête. Doit être un entier compris entre 1 et 4.
string[]
Tableau contenant jusqu’à 16 images de référence. Sans références, la génération se fait à partir de texte ; avec des références, elle se fait à partir d’images. Les références n’entraînent aucun supplément.Formats d’entrée acceptés :
  • URL d’images accessibles
  • Data URL: data:image/...;base64,...

Exemples d’utilisation

Les exemples suivants sont des corps de requête JSON pour POST /v1/images/generations. Utilisez l’authentification et les en-têtes recommandés ci-dessus. Remplacez les adresses des images de référence par de véritables URL d’images accessibles.

Génération à partir de texte

Génération à partir d’images avec Sunburst

Plusieurs images de référence et de sortie

Rapport d’aspect automatique et résolution 4K

Consulter les résultats d’une tâche

Utilisez l’ID de tâche pour appeler l’endpoint de consultation des tâches :

Tâche réussie

L’ID de tâche, les horodatages, les URL et les montants ci-dessous illustrent uniquement la structure de la réponse. Ils ne correspondent pas à une tâche réelle ni aux tarifs en vigueur.

Réponse

integer
Code de statut de la réponse. Un envoi réussi au format unifié renvoie 200.
string
Identifiant de cette requête, utilisé pour le diagnostic.
object
La tâche asynchrone acceptée.