API de génération d’images GPT Image 2 / 2.5

1. Obtenir une clé API

Ouvrez la liste des applications Ace Data Cloud, accédez à une application disponible et copiez la clé API. Obtenir une clé API Ace Data Cloud

2. Envoyer la première requête

curl https://api.acedata.cloud/openai/images/generations \
  -H "Authorization: Bearer 你的 API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Minimal editorial product illustration: one plain white ceramic coffee mug centered on a solid cobalt blue tabletop, pale cream background, soft shadow, clean geometric shapes, no text, no logo, portrait composition",
    "size": "1024x1536"
  }'

L’image de la réponse réussie se trouve dans data[].url. Voici le résultat 1024×1536 obtenu par une requête réelle via Ace Data Cloud le 8 septembre 2026 (tâche d56455e2-e7f7-4bcd-b935-475b0a1e0948, trace eb938601-8192-407f-b539-1e0554b697ec) : Tasse blanche générée par GPT Image 2

3. Paramètres courants

Champ	Description
`model`	`gpt-image-2` (recommandé par défaut), `gpt-image-2.5-flare` (plus rapide) ou `gpt-image-2.5-sunburst` (fidélité et contrôle supérieurs) ; les trois peuvent sélectionner la variante `:official` correspondante, et `gpt-image-2` prend également en charge `:reverse`
`prompt`	Description de l’image, jusqu’à 32 000 caractères
`size`	`auto` ou `WIDTHxHEIGHT` ; la largeur et la hauteur doivent être des multiples de 16, le côté le plus long ne doit pas dépasser 3840, le total des pixels doit être de 655 360 à 8 294 400, et le rapport largeur/hauteur ne doit pas dépasser 3:1
`n`	1–10 ; uniquement 1 lorsque `response_format=b64_json`
`quality`	`low`, `medium`, `high` ou `auto` ; la prise en charge et le mode de facturation diffèrent selon les canaux
`response_format`	`url` ou `b64_json`
`callback_url`	Facultatif ; envoie le résultat à cette adresse une fois une tâche longue terminée

Tailles courantes :

Proportion	1K	2K	4K
1:1	`1024x1024`	`2048x2048`	`2880x2880`
4:3	`1536x1024`	`2048x1536`	`3264x2448`
3:4	`1024x1536`	`1536x2048`	`2448x3264`
16:9	`1792x1024`	`2048x1152`	`3840x2160`
9:16	`1024x1792`	`1152x2048`	`2160x3840`

size: "auto" sélectionne le format d’image en fonction de la proportion, des pixels et de l’intention de mise en page dans l’invite ; pour des pixels précis, renseignez directement la taille.

Modèles et modes de facturation

Modèle	Cas d’usage et mode de facturation
`gpt-image-2`	Canal inversé par défaut, facturation fixe par nombre d’images réussies
`gpt-image-2:reverse`	Sélection explicite du canal inversé, facturation fixe par nombre d’images réussies
`gpt-image-2:official`	Canal d’API officiel, stabilité supérieure, facturation selon l’utilisation réelle de Tokens
`gpt-image-2.5-flare`	Axé sur la vitesse de génération, facturation fixe par nombre d’images réussies
`gpt-image-2.5-flare:official`	Canal d’API officiel, stabilité supérieure et axé sur la vitesse de génération, facturation selon l’utilisation réelle de Tokens
`gpt-image-2.5-sunburst`	Axé sur la haute fidélité et le contrôle précis, facturation fixe par nombre d’images réussies
`gpt-image-2.5-sunburst:official`	Canal d’API officiel, stabilité supérieure et axé sur la haute fidélité et le contrôle précis, facturation selon l’utilisation réelle de Tokens

Le prix affiché pour le canal d’API officiel est une estimation avant la requête ; le montant final est basé sur l’utilisation réelle de Tokens dans la réponse et les relevés d’utilisation.

4. Génération de plusieurs images

curl https://api.acedata.cloud/openai/images/generations \
  -H "Authorization: Bearer 你的 API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A small fox reading under a glowing mushroom, watercolor illustration",
    "size": "1536x1024",
    "n": 2
  }'

gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst et gpt-image-2:reverse sont facturés selon le nombre d’images réussies ; gpt-image-2:official, gpt-image-2.5-flare:official et gpt-image-2.5-sunburst:official sont facturés selon les Tokens réels d’entrée textuelle et de sortie d’image dans la réponse. Le prix affiché est une estimation avant la requête ; le montant final est basé sur les relevés d’utilisation.

5. Rappel asynchrone

Après avoir ajouté callback_url au corps de la requête, l’interface renvoie d’abord {"task_id": "..."} et envoie le résultat final par POST à cette URL une fois terminée ; les requêtes synchrones renvoient toujours created et data :

{
  "model": "gpt-image-2",
  "prompt": "A product poster with clear typography",
  "size": "1024x1024",
  "callback_url": "https://example.com/webhooks/images"
}

Le destinataire du rappel doit dédupliquer à l’aide de task_id, et vérifier l’origine de la requête ainsi que le format des données.

6. Dépannage

Statut	Vérifier
400	La combinaison de `model`, `prompt`, du format de taille, de `n` et de `response_format`
401	Si la clé API est complète, et si le Header est `Authorization: Bearer ...`
429	Les requêtes sont trop fréquentes, réessayez plus tard
504	Délai d’expiration de la génération synchrone ; utilisez `callback_url`

Les réponses d’erreur contiennent error.code, error.message et trace_id. Lors du signalement d’un problème, fournissez le trace_id, mais ne fournissez pas la clé API. Pour les champs complets et les énumérations en temps réel, consultez la page API OpenAI Images Generations. Pour la modification d’images, consultez Modification d’images GPT Image 2 / 2.5.

Démarrage

Chat IA

Image IA

Vidéo IA

Audio IA

Web & Données

CAPTCHA

Identité

Coding

Autres guides

API de génération d’images GPT Image 2 / 2.5

1. Obtenir une clé API

2. Envoyer la première requête

3. Paramètres courants

Modèles et modes de facturation

4. Génération de plusieurs images

5. Rappel asynchrone

6. Dépannage

​1. Obtenir une clé API

​2. Envoyer la première requête

​3. Paramètres courants

​Modèles et modes de facturation

​4. Génération de plusieurs images

​5. Rappel asynchrone

​6. Dépannage

1. Obtenir une clé API

2. Envoyer la première requête

3. Paramètres courants

Modèles et modes de facturation

4. Génération de plusieurs images

5. Rappel asynchrone

6. Dépannage