GPT Image 2.6

GPT Image 2.6 accepte des prompts texte et des images de référence facultatives. Soumettez une fois à POST /v1/images/generations, conservez l’identifiant de tâche et interrogez GET /v1/tasks/{id} pour obtenir le résultat. Les fichiers terminés sont renvoyés sous forme d’URL.

ID des modèles et tarifs

Utilisez GET /v1/models pour découvrir les modèles disponibles avec votre clé. Les ID Sunburst configurés sont gpt-image-2.6-sunburst-official et gpt-image-2.6-sunburst. Les ID Flare, lorsqu’ils sont listés, suivent le même contrat de paramètres. L’ID de modèle nu utilise son groupe Default ; les groupes supplémentaires utilisent l’ID model:group indiqué par la découverte.

Consultez les tarifs actuels et le Playground. Les modèles facturés au token sont réglés selon l’usage réel ; les modèles facturés par image utilisent le prix configuré par image. Les réponses SVG déclarent séparément les tokens du modèle qui écrit leur code dans svg_usage, facturés au tarif SeedRouter propre à ce modèle.

Générer une image

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

La réponse contient un id. Interrogez cet ID au lieu de soumettre à nouveau la génération :

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

À la fin, output.data contient des objets avec une url. Téléchargez l’URL pour conserver le format de fichier d’origine et, pour les GIF, chaque image de l’animation. Une tâche échouée contient une error et n’est pas facturée. Voir les états des tâches et l’interrogation.

Paramètres

Il existe 18 champs de premier niveau. Seuls model et prompt sont obligatoires. Les champs facultatifs acceptent null, traité comme une omission. Les champs inconnus sont écartés. Les valeurs prises en charge mais invalides échouent à la validation avant la génération d’image.

Les URL de référence doivent utiliser HTTP ou HTTPS sans contenir d’identifiants d’authentification. Les ID de fichiers, le base64 intégré et les envois multipart ne sont pas acceptés ; téléversez d’abord les fichiers et fournissez leurs URL publiques. Les requêtes utilisent l’interrogation de tâches asynchrones plutôt que stream ou partial_images. input_fidelity, response_format et prompt_rewriter ne sont pas exposés par ce contrat.

Taille de l’image

Pour la génération d’images de référence PNG, JPEG et SVG, chaque dimension doit être divisible par 16 et ne pas dépasser 3840 pixels. Le nombre total de pixels doit être compris entre 655 360–8 294 400 et le rapport d’aspect entre 1:3 et 3:1. Exemples : 1024x1024, 1536x1024, 2160x3840, 2880x2880.

Les dimensions GIF doivent être des multiples positifs de 16, ou utilisez auto. GIF a un budget total de pixels distinct, partagé entre le nombre d’images, leurs dimensions et n ; OpenAI n’en a pas publié la limite numérique. Un GIF 512x512 n’utilise pas la règle du minimum de pixels des images fixes.

GIF animé

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

Un GIF peut être généré à partir d’un prompt ou demandé à partir d’images de référence. Ne le combinez pas avec un masque ou de la compression. La disponibilité de l’aperçu peut dépendre de l’accès au modèle sélectionné.

Divergence de documentation, vérifiée le 5 novembre 2026 : le guide de génération d’images d’OpenAI indique 2–64 images et 20–2000 ms, et affirme que le point de terminaison de retouche ne renvoie pas de GIF. La référence de l’API Images indique 2–16 images, aucune durée maximale et liste la sortie GIF pour les retouches. Les requêtes en amont du 5 novembre 2026 correspondaient à la référence : 17 images ont été refusées et une durée d’affichage de 3 000 ms a été acceptée. Cette API suit la référence.

SVG

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

SVG est réservé à la génération et exige n: 1. N’envoyez ni images, ni masque, ni annotations, ni compression. Le fichier est du XML UTF-8 statique contenant des formes vectorielles ; les scripts, les ressources externes et les images matricielles intégrées ne sont pas pris en charge.

Lorsque le choix du modèle d’écriture est disponible, ajoutez svg: {"model":"YOUR_AUTHOR_MODEL_ID"}. Un objet svg explicitement fourni exige un model non vide. Vous pouvez aussi régler svg.reasoning.effort sur none, minimal, low, medium, high, xhigh ou max ; le modèle d’écriture choisi détermine les valeurs qu’il prend en charge. Omettez reasoning pour utiliser sa valeur par défaut. OpenAI ne publie ni liste de modèles d’écriture autorisés ni valeur par défaut universelle. Si ce choix est indisponible, omettez l’objet svg entier.

Le résultat terminé peut inclure svg_usage avec model, input_tokens, output_tokens, reasoning_tokens et total_tokens. Ces données sont distinctes de l’usage de l’image ; il ne s’agit pas d’un décompte supplémentaire de tokens d’image.

Images de référence, masque et annotations

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

Les images de référence acceptent PNG, JPEG et WebP, au plus 50 Mo chacune. Le masque et les annotations doivent être en PNG et correspondre aux dimensions de la première image de référence après orientation. Les annotations doivent contenir des pixels transparents ; les annotations comme la première image de référence peuvent contenir au plus 16 777 216 pixels, et les annotations peuvent peser au plus 50 Mo. Le masque et les annotations sont mutuellement exclusifs.

Champs de réponse

La sortie d’image terminée contient created, data: [{url}] et, lorsque ces données sont rapportées, size, quality, background, output_format, usage, svg_usage et safety_identifier. usage peut détailler les tokens de texte et d’image en entrée et en sortie, ainsi que l’entrée en cache. La sortie publique ne contient ni octets d’image en base64 ni champs de coût.

Schéma OpenAPI · Référence de génération OpenAI · Référence de retouche OpenAI · Guide des images OpenAI