GPT Image 2.6 Génération d'images

Nom du modèle de génération d'images, offrant une meilleure stabilité et un meilleur contrôle pour les usages commerciaux

Les deux modèles acceptent exactement les mêmes paramètres. À niveau quality identique, la consommation réelle de tokens peut légèrement varier ; référez-vous au usage renvoyé.

Invite décrivant l'image à générer ou la manière de modifier l'image d'entrée

Limites de longueur (les deux doivent être respectées) :

• Jusqu'à 32 000 caractères (comptés en points de code Unicode)
• Le texte de prompt lui-même ne doit pas dépasser 60 000 octets après encodage en UTF-8

Les caractères peuvent occuper un nombre différent d'octets en UTF-8. Fiez-vous au nombre réel d'octets après encodage.

Si l'une des limites est dépassée, raccourcissez l'invite avant de la renvoyer.

Recommandation : Si l'invite dépasse 8000 tokens, l'image générée peut ne pas correspondre aux attentes ; il est recommandé de raccourcir l'invite.

URL du masque d'inpainting — marque la région de l'image de référence à régénérer. Valide uniquement en mode édition d'image (doit être combiné avec image_urls) ; en texte-vers-image pur, le masque est silencieusement ignoré.

Exigences de format :

• Doit être un PNG avec canal alpha : pixels transparents (alpha < 255) = zones à régénérer, pixels opaques = préservés
• Les dimensions du masque doivent correspondre exactement à celles de l'image de référence (largeur × hauteur en pixels)
• Un seul masque par requête

Remarque :

• Au moins une image de référence est requise dans image_urls ; un masque seul n'a aucun effet
• Erreurs courantes :
  • Invalid mask image format - mask image missing alpha channel : l'image téléchargée n'a pas de canal alpha (JPEG, PNG opaque, etc.). Réexportez le masque en PNG avec des régions transparentes.
  • Invalid mask image format - mask size does not match image size : les dimensions du masque ne correspondent pas à l'image de référence. Redimensionnez le masque aux mêmes dimensions en pixels que votre image de référence.
• Ne peut pas être combiné avec markup_url.

URL publique du calque d'annotations. Utilisez des cercles, des flèches ou des dessins pour indiquer les zones à modifier sur l'image de référence, et décrivez les changements dans prompt. Disponible uniquement en mode édition d'image (image_urls doit également être fourni).

Exigences de format :

• PNG contenant des pixels transparents obligatoire : dessinez uniquement les annotations et laissez le reste transparent. Ne dessinez pas directement sur l'image d'origine.
• Les dimensions doivent correspondre exactement à celles de la première image de référence (largeur × hauteur en pixels).
• La première image de référence et le calque d'annotations ne doivent pas dépasser 16 777 216 px chacun.
• Taille de fichier : au maximum 50MB

Remarques :

• Les annotations s'appliquent à la première image de image_urls ; les autres images servent de références.
• Ne peut pas être combiné avec mask_url.
• Prend en charge l'édition d'images classiques et de GIF.
• Peut aussi être fourni dans model_params.markup_url. Si les deux valeurs sont présentes, celle de premier niveau est prioritaire.
• Précisez également dans prompt ce qui doit être conservé, par exemple « Laisse le reste inchangé et supprime le cercle rouge ».

Dimensions de l'image générée, auto par défaut. Les images classiques suivent les règles ci-dessous ; les GIF suivent les règles distinctes de la section ④.

① Images classiques : format ratio (15 possibilités)

• 1:1 : carré
• 1:2 / 2:1 : très vertical / très horizontal
• 1:3 / 3:1 : extrêmement vertical / horizontal (limite de 3:1)
• 2:3 / 3:2 : portrait / paysage standard
• 3:4 / 4:3 : portrait / paysage classique
• 4:5 / 5:4 : formats courants pour les réseaux sociaux
• 9:16 / 16:9 : écran large mobile / ordinateur
• 9:21 / 21:9 : écran ultra-large

② Images classiques : dimensions explicites en pixels : WxH (ou W×H), par exemple 1024x1024, 1536x1024, 3840×2160

• La largeur et la hauteur doivent être des multiples de 16.
• Plage de chaque côté : [16, 3840]
• Budget de pixels : 655 360 ≤ width × height ≤ 8 294 400 (environ 0,65 MP à 8,29 MP)
• Ratio : ≤ 3:1

③ Images classiques : auto : le modèle détermine automatiquement les dimensions (resolution n'a alors aucun effet).

④ Sortie GIF : size désigne les dimensions de chaque frame. Seuls auto et les dimensions explicites en pixels sont acceptés, pas les ratios.

• Avec auto, chaque frame mesure 512×512.
• La largeur et la hauteur explicites de chaque frame doivent être des multiples positifs de 16.
• La limite minimale de 655 360 pixels des images classiques ne s'applique pas aux frames GIF individuelles. Par exemple, 512x512 est valide.
• L'image composée de toutes les frames doit respecter les limites de longueur des côtés, de nombre total de pixels et de ratio. Consultez model_params.frame_count pour les dispositions et les limites par frame.
• resolution n'a aucun effet.

En cas de dépassement :

• Si la combinaison du ratio et de resolution dépasse le budget d'une image classique, elle est réduite proportionnellement jusqu'à la limite (par exemple, 4K 2:1 → 3840×1920).
• Des dimensions explicites de frame GIF dépassant les limites entraînent directement HTTP 400, sans réduction automatique.

Paramètre rapide de palier de résolution. Effectif uniquement lorsque size est au format ratio ; ignoré pour les dimensions explicites en pixels et les sorties GIF.

Règles de budget pixel (les dimensions sont calculées à partir du nombre total de pixels cible et du ratio size, alignées sur des multiples de 16) :

• 1K : ~1 MP (1024² = 1 048 576 pixels)
• 2K : ~4 MP (2048² = 4 194 304 pixels)
• 4K : ~8,29 MP (3840×2160 = 8 294 400 pixels, le maximum)

Dimensions de sortie paysage / carré (les dimensions portrait correspondent au paysage avec largeur/hauteur inversées, par exemple 2:3 = 3:2 inversé) :

* Indique les combinaisons automatiquement réduites pour respecter le budget de pixels. Les valeurs sont insensibles à la casse.

Qualité du rendu, qui influence directement le nombre de tokens de sortie et le coût. Valeur par défaut : medium.

Remarques :

• Le tableau compare uniquement les coûts de sortie image, sans les coûts d'entrée.
• Ces valeurs sont calculées pour 1024×1024. Le nombre de tokens de sortie varie selon le nombre total de pixels et le ratio. Référez-vous au usage renvoyé.
• Pour un GIF, le calcul porte sur l'image composée de toutes les frames.
• Utilisez low pour les brouillons rapides. Pour le résultat final, comparez plusieurs niveaux afin d'équilibrer détails, durée et coût.

Profondeur de planification avant la génération de l'image, indépendante de quality. Valeur par défaut : high.

• low : adapté aux modifications locales, comme changer un arrière-plan ou le texte d'une enseigne
• medium : équilibré
• high : adapté aux images riches en texte, aux mises en page complexes ou aux relations complexes entre objets

Remarques :

• Les niveaux élevés prennent plus de temps et peuvent introduire des modifications indésirables. Comparez les résultats selon la tâche.
• Modifier complexity n'entraîne pas de facturation supplémentaire.
• Peut aussi être fourni dans model_params.complexity. Si les deux valeurs sont présentes, celle de premier niveau est prioritaire.

Canal d'arrière-plan de l'image de sortie, opaque par défaut.

• opaque : arrière-plan opaque, sans canal alpha
• transparent : conserve le canal alpha

Remarques :

• transparent est actuellement une fonctionnalité en Preview ; les résultats peuvent être instables.
• Avec transparent, output_format doit être png ou webp.
• Avec output_format=gif, seul opaque est accepté.

Format du fichier de sortie, png par défaut.

• png : sans perte, prend en charge les arrière-plans transparents
• jpeg : compression avec perte pour réduire la taille du fichier
• webp : compromis entre taille et qualité, avec prise en charge de la transparence
• gif : GIF animé ; le nombre de frames et leur durée se définissent dans model_params

Remarques :

• Avec background=transparent, seuls png et webp sont acceptés.
• gif prend en charge le texte vers image et l'édition d'images.
• Pour gif, n doit être égal à 1.

Nombre d'images à générer. Chaque image est facturée séparément.

Remarques :

• Les tokens d'entrée texte augmentent proportionnellement à n.
• La prise en charge de n > 1 est actuellement peu fiable : même avec une valeur supérieure à 1, une seule image peut être renvoyée. Le nombre réel est celui de results et la facturation repose sur le usage renvoyé. Pour obtenir plusieurs images, il est recommandé d'envoyer plusieurs requêtes d'une seule image.
• Avec output_format=gif, seule la valeur 1 est acceptée.

Adresse de rappel HTTPS après l'achèvement de la tâche

Moment du rappel :

• Déclenché lorsque la tâche est terminée, échouée ou annulée
• Envoyé après confirmation de la facturation

Restrictions de sécurité :

• Seul le protocole HTTPS est pris en charge
• Les rappels vers les adresses IP internes sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
• La longueur de l'URL ne doit pas dépasser 2048 caractères

Mécanisme de rappel :

• Délai d'expiration : 10 secondes
• Maximum 3 tentatives en cas d'échec (tentatives après 1 seconde/2 secondes/4 secondes)
• Le format du corps de réponse du rappel est cohérent avec le format de réponse de l'API de requête de tâche
• Un code de statut 2xx renvoyé par l'adresse de rappel est considéré comme un succès, les autres codes de statut déclenchent une nouvelle tentative

Horodatage de création de la tâche

ID de tâche

Nom du modèle réellement utilisé

Type spécifique de tâche

Pourcentage de progression de la tâche (0-100)

État de la tâche. Les tâches en attente et en cours de génération sont toutes renvoyées avec processing ; l’état final est completed ou failed.

Type de sortie de la tâche