Passer au contenu principal
POST
Modèle : gpt-image-2.6-ext, avec version égal à flare / sunburst. Facturation par image. Pris en charge : resolution 1k / 2k / 4k avec n: 1, tous les niveaux de qualité et PNG / JPEG / WebP / SVG / GIF.
Cette page décrit l’API Ext. Le nom du modèle et les paramètres diffèrent des modèles GPT-Image-2.6 facturés au token.

Authentification

string
requis
Utilisez une clé API de la plateforme en Bearer Token, disponible sur la page des clés API. Envoyez Content-Type: application/json.

Choix de la version

Paramètres

Les valeurs énumérées ignorent la casse et les espaces en début et fin. Les exemples utilisent des minuscules.
string
requis
Valeur fixe : gpt-image-2.6-ext.
string
requis
Instructions obligatoires et non vides. Avec plusieurs références, désignez la première ou la deuxième image et précisez les éléments à modifier ou conserver.
string
défaut:"flare"
flare / sunburst, valeur par défaut flare. Autres valeurs : HTTP 400. Les tarifs peuvent différer entre versions.
string
défaut:"1k"
1k / 2k / 4k (majuscules 1K / 2K / 4K acceptées). Combiné au ratio size, il détermine les pixels de sortie ; voir le tableau « Ratios et dimensions » ci-dessous. Le prix par image dépend du niveau ; les autres valeurs telles que hd / 8k renvoient HTTP 400.
string
défaut:"auto"
auto ou les 10 ratios ci-dessous uniquement, pas de pixels tels que 1024x1024. Avec auto, la génération depuis du texte utilise 1:1 ; la retouche choisit le ratio accepté le plus proche de la première référence dont les dimensions sont lisibles. Pour GIF, omettez ou utilisez auto.
string
Alias de size ; un seul champ suffit. Si les deux sont présents, ils doivent correspondre, sinon HTTP 400. Pour GIF, omission ou auto uniquement.
integer
défaut:"1"
Utilisez actuellement l’entier 1.
string
auto / low / medium / high / xhigh / max. Si omis, le champ n’est pas transmis et le modèle amont choisit. auto n’est pas fixé à low. Le prix par image est identique ; les niveaux élevés prennent généralement plus de temps. Autres valeurs : HTTP 400.
string
défaut:"png"
png / jpeg / webp / svg / gif ; jpg est un alias de jpeg. SVG et GIF : génération depuis du texte uniquement. Autres formats : HTTP 400.
La sortie SVG n’est pas encore prise en charge.
string
low / medium / high ; décision du modèle amont si omis. Contrôle la complexité : low pour icônes simples et illustrations plates, high pour des détails riches. Aucun effet sur le prix par image.
string[]
Au plus 16 images de 20 MB maximum chacune. PNG / JPEG / WebP / GIF / BMP. URL HTTP(S) publiques ou Data URL d’image comme data:image/png;base64,.... Leur présence active la retouche. Aucune référence avec SVG ou GIF.
Lorsque resolution vaut 2k / 4k, les images de référence ne peuvent pas être au format GIF / BMP.
Alias acceptés : image_url, image, images, input_image, input_images. Préférez image_urls. Les URL doivent être publiques et accessibles sans connexion.

Ratios et dimensions

Avec auto, la génération depuis du texte utilise 1:1 : 1024×1024 en 1k, 2048×2048 en 2k, 2880×2880 en 4k. La retouche sélectionne le ratio le plus proche ci-dessous, sans garantir les dimensions originales.

Exemple avec références

La retouche utilise aussi POST /v1/images/generations. Remplacez les URL d’exemple par des images accessibles.

Sortie SVG

Définissez output_format: "svg". Texte uniquement, avec n=1. size accepte les ratios ; complexity: "low" convient aux dessins vectoriels simples.
object
Configuration facultative du modèle de rédaction SVG, réservée au format SVG. L’objet entier peut être omis. Le modèle de texte n’entraîne aucun supplément.

GIF animés

Définissez output_format: "gif". Texte uniquement. Omettez size / aspect_ratio ou utilisez auto ; ratios et dimensions en pixels renvoient HTTP 400. Décrivez le mouvement et la boucle.

Paramètres non pris en charge ou ignorés

Soumission et résultats

Soumission réussie : HTTP 200. Lisez data[0].task_id, puis consultez l’API de statut toutes les 3–5 secondes jusqu’à completed ou failed. Si le client expire, continuez à consulter la tâche existante au lieu de relancer une génération.
L’exemple montre l’objet tâche. Si la réponse utilise une enveloppe {code, data}, lisez d’abord data. Les exemples Python / JavaScript gèrent les deux formes.
result.images[0].url est un tableau ; son premier lien est result.images[0].url[0]. Téléchargez avant expires_at ; la validité recommandée est de 24 heures après la fin. cost / credits_cost indiquent les frais finaux. Consultation groupée : POST /v1/tasks/batch avec {"task_ids":["task_xxx","task_yyy"]}.

Facturation

Le prix par image dépend uniquement de version × resolution. Qualité, format (SVG / GIF inclus), complexité, ratio, nombre de références et svg.model ne le modifient pas. Utilisez actuellement n=1 ; les échecs sont intégralement remboursés. Tarifs sur la page des prix APIMart ou /api/pricing.

Gestion des erreurs