Référence développeur

Documentation de l’API GPT Image 2.6

Créez une clé API, envoyez une demande de génération, puis consultez la tâche pour récupérer votre image.

Créer votre clé API

Connectez-vous et créez une clé dans votre compte. Définissez GPT_IMAGE_API_KEY avec cette clé dans l’environnement de votre serveur avant d’exécuter les exemples.

Gérer les clés API

Conservez votre clé sur votre serveur. Les deux points d’accès utilisent votre clé API utilisateur via Authorization: Bearer, sans cookie de navigateur.

Les demandes de génération consomment les crédits de votre compte. À paramètres identiques, Flare et Sunburst ont le même coût en crédits. Consulter les coûts actuels

Envoyer une demande de génération

POST /api/generate

Enregistrez le JSON ci-dessous dans request.json. Cet exemple génère une image à partir de texte. Pour modifier une image avec des références, ajoutez le tableau images décrit plus bas.

Corps de la requête : `request.json`

{
  "model": "gpt-image-2.6",
  "variant": "flare",
  "prompt": "Une tasse en céramique bleue sur une table en bois, devant un fond de papier aux tons chauds.",
  "quality": "medium",
  "resolution": "1k",
  "complexity": "high",
  "output_format": "png"
}

Envoyer depuis votre serveur

curl --request POST https://gptimage-26.com/api/generate \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --header "Content-Type: application/json" \
  --data @request.json

Un envoi réussi renvoie code 200, data.task_id, data.status défini sur IN_PROGRESS et data.consumed_credits. Conservez data.task_id pour consulter l’état de la tâche.

Champs de la requête

Champ	Signification et valeurs acceptées
`model`	Utilisez gpt-image-2.6. C’est également la valeur par défaut si le champ est omis.
`variant`	Facultatif : flare, sunburst. Valeur par défaut : flare. Indiquez sunburst pour utiliser Sunburst.
`prompt`	Texte obligatoire, de 1 à 20000 caractères après suppression des espaces en début et fin.
`quality`	Facultatif : low, medium, high, xhigh, max. Valeur par défaut : medium.
`resolution`	Facultatif : 1k, 2k, 4k. Valeur par défaut : 1k.
`complexity`	Planification de la composition, facultatif : low, medium, high. Valeur par défaut : high.
`output_format`	Facultatif : png, jpeg, webp. Valeur par défaut : png.
`images`	Tableau facultatif contenant au plus 16 URL d’images HTTP(S). Une ou plusieurs références activent la modification ; omettez ce champ pour générer une image à partir de texte.

Consulter la tâche

GET /api/status

Définissez TASK_ID avec la valeur data.task_id reçue. Envoyez-la dans le paramètre de requête task_id avec la même clé API utilisateur.

curl --get https://gptimage-26.com/api/status \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --data-urlencode "task_id=$TASK_ID"

PENDING / IN_PROGRESS: La tâche est en cours. Interrogez à nouveau ce point d’accès pour suivre son état.
SUCCESS: Récupérez les URL des images générées dans le tableau data.response.
FAILED: Consultez data.error_message pour comprendre l’échec avant de décider d’envoyer une nouvelle demande.

Exemple de tâche terminée

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "<TASK_ID>",
    "status": "SUCCESS",
    "response": [
      "<IMAGE_URL>"
    ],
    "error_message": null
  }
}

Les valeurs entre chevrons représentent l’identifiant de tâche et l’URL d’image renvoyés par votre demande.