Skip to main content
POST
Alias de modèle compatible : cette API prend également en charge l’alias gpt-image-2-ext, équivalent à gpt-image-2 ; les deux sont interchangeables et produisent des résultats identiques.

Autorisations

string
requis
Tous les points de terminaison nécessitent une authentification Bearer TokenObtenir votre clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APIIncluez-la dans l’en-tête de la requête :

Body

string
défaut:"gpt-image-2"
requis
Nom du modèle de génération d’imagesFixé à gpt-image-2 (alias compatible gpt-image-2-ext)
Pour assurer la compatibilité avec les anciens appels, l’alias gpt-image-2-ext (correspondant à gpt-image-2) reste utilisable normalement.
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche d’image.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Description textuelle pour la génération d’images
  • Prend en charge l’anglais et le chinois, des descriptions détaillées sont recommandées
  • Modération de contenu / examen de sécurité avant soumission — les violations sont rejetées immédiatement
integer
défaut:"1"
Nombre d’images à générerValeur : 1
Doit être un nombre brut (par exemple 1), ne pas mettre entre guillemets
string
défaut:"1:1"
Ratio d’aspect de l’imageRatios pris en charge, plus auto pour laisser le serveur choisir automatiquement un ratio adapté :Les dimensions en pixels peuvent également être transmises directement, par exemple 1881x836 / 887x1774.
Lorsque size est défini sur auto, le ratio par défaut est 1:1.
string
défaut:"1k"
Niveau de résolution de sortieOptions : 1k / 2k / 4kCorrespondance size × resolution → pixels réels :
La 4K prend en charge les 15 ratios listés ci-dessus ; vous pouvez également transmettre les dimensions en pixels du tableau directement via size.
array
Tableau d’images de référence (champ standard OpenAI). Passe en mode image-vers-image lorsqu’il est fourni.
Les autres champs standard OpenAI (response_format, style) ne sont pas pris en charge et seront ignorés. Les résultats des tâches ne renvoient que url — veuillez télécharger et convertir en base64 vous-même si nécessaire.
boolean
défaut:"false"
Faut-il basculer vers le canal officiel
  • false : Ne pas utiliser (par défaut)
  • true : Utiliser le canal officiel

Exemples d’utilisation

Texte-vers-image (requête minimale)
Texte-vers-image (avec ratio + 2K)
Texte-vers-image (sortie 4K)
Texte-vers-image (multiple)
Image-vers-image (référence = URL)
Image-vers-image (référence = base64)
Image-vers-image (fusion multi-références, URL + base64 mélangés)

Response

integer
Code de statut de la réponse
array
Tableau de données de réponse

Interrogation des résultats de tâche

Après une soumission réussie, un task_id est renvoyé. Interrogez l’état de la tâche via GET /v1/tasks/{task_id}, voir API d’interrogation des tâches pour plus de détails.

Exemple de réponse en cas de succès

Accès à l’image : data.result.images[0].url[0]

Statuts de tâche