Différences de paramètres et d’API de GPT-Image

Comprendre les différences de paramètres et l’utilisation de GPT-Image pour la génération et la modification d’images.

Adaptez les paramètres de génération, de modification et de sortie au modèle choisi. Consultez Créer une image et Modifier une image pour les structures complètes des requêtes et des réponses.

Modèles concernés

Modèle	API prises en charge
gpt-image-2.6-sunburstNouveau gpt-image-2.6-flareNouveau gpt-image-2.5-sunburst gpt-image-2.5-flare gpt-image-2 gpt-image-1.5	OpenAI Images : Créer une image, Modifier une image

Différences des paramètres de génération

Champ	Différence
`quality`	2.6 et 2.5 acceptent `auto/low/medium/high/xhigh/max` ; 2 et 1.5 acceptent `auto/low/medium/high`. La valeur par défaut est toujours `auto`
`size`	1.5 accepte `auto`, `1024x1024`, `1024x1536` et `1536x1024` ; 2 et 2.5 acceptent des dimensions personnalisées, avec des côtés multiples de 16 et limités à 3840, un rapport de 1:3 à 3:1 et un total de 655360 à 8294400 pixels. Les tailles supérieures à 3686400 pixels sont expérimentales
`size` (2.6)	Accepte `auto` ou des dimensions personnalisées multiples de 16, avec un rapport de 1:3 à 3:1. Les GIF ont aussi des limites de nombre d’images et de budget total de pixels ; ne reprenez pas telles quelles les dimensions d’une image statique
`complexity`	2.6 accepte `low/medium/high`, avec `high` par défaut. Contrôle la planification avant génération ; `quality` contrôle les détails du rendu. Ces réglages sont indépendants
`background`	Pour un fond transparent, définissez explicitement `transparent` et utilisez `png` ou `webp` pour la sortie matricielle. JPEG ne conserve pas le canal alpha. Sur 2, les fonds transparents sont une fonctionnalité officielle en préversion

Différences des paramètres de modification

Champ	Différence
`input_fidelity`	1.5 accepte `low/high`, avec `low` par défaut ; choisissez `high` pour préserver les détails d’entrée. 2 traite toujours les images en haute fidélité : omettez ce champ. Omettez-le aussi pour 2.6 ; ne recopiez pas les réglages de 1.5 sur les nouveaux modèles
`markup`	2.5 et 2.6 acceptent les modifications guidées par annotations. Fournissez une surcouche PNG avec des zones transparentes, de mêmes dimensions que la première image après correction de l’orientation, et décrivez les changements dans le prompt
`mask`, `markup`	Choisissez l’un des deux ; avec plusieurs images, il s’applique à la première. Le masque utilise la transparence pour délimiter la zone à modifier ; les annotations utilisent des cercles, des flèches ou d’autres repères
`output_format`	Utilisez `png/jpeg/webp` pour les modifications ; utilisez l’API de création d’images pour les sorties SVG ou GIF

Différences des formats de sortie

Champ	Différence
`output_format`	Les six modèles acceptent `png/jpeg/webp`, avec `png` par défaut ; la création d’images avec 2.6 accepte aussi `svg/gif`
`output_compression`	Uniquement pour `jpeg/webp`, dans la plage `0～100` ; omettez pour PNG, SVG et GIF
SVG	Pour créer une image avec 2.6, définissez `output_format: "svg"` et `n: 1` ; n’utilisez ni streaming ni images partielles. Décodez `data[0].b64_json` et enregistrez en `.svg` ; le contenu est du XML UTF-8
`svg`	Sélectionne le modèle de création du SVG, distinct du `model` d’image au niveau supérieur. Renseignez `svg.model` uniquement si la sélection de modèle SVG est activée ; sinon, omettez tout l’objet. `svg.reasoning` et le réglage `complexity` de l’image sont indépendants
GIF	Pour créer une image avec 2.6, définissez `output_format: "gif"` ; n’utilisez ni streaming, ni images partielles, ni compression personnalisée. Décodez `data[].b64_json` et enregistrez en `.gif`
`frame_count`	GIF uniquement, `2～16` images, avec `9` par défaut. Le nombre d’images, leurs dimensions et `n` partagent un budget total de pixels ; réduisez l’un de ces paramètres en cas de dépassement
`frame_duration_ms`	GIF uniquement, `20～2000` millisecondes, avec `200` par défaut, arrondies à 10 ms

Exemples de requêtes

Remplacez MODEL_ID par l’identifiant complet du modèle fourni par la plateforme. Les exemples de génération, de SVG et de GIF ci-dessous utilisent 2.6 ; la modification annotée utilise 2.5 ou 2.6.

curl 'https://api.agtcloud.ai/v1/images/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "prompt": "Une affiche simple pour l’ouverture d’un café, avec le titre OPEN TODAY et une typographie lisible",
    "quality": "medium",
    "complexity": "high",
    "size": "1024x1024",
    "output_format": "png"
  }'