Appelle la gpt-image-2 API avec un token Bearer et récupère un PNG hébergé en environ 45 secondes. Text-to-image et image-to-image partagent le même endpoint. 2 crédits par image, sans engagement, sans SDK à installer. Crée ta clé et lance ton premier rendu en curl avant que ton café n'arrive.
Utilisée par 10 000+ développeurs qui livrent avec la gpt-image-2 API
Un endpoint. Auth Bearer. Sortie hébergée. Rien d'autre à câbler.
La gpt-image-2 API est une surface REST qui transforme un prompt (et jusqu'à quatre images de référence) en un PNG prêt pour la production. Tu envoies un POST vers /api/v1/images/generate avec un token Bearer, tu reçois un task_id, puis tu interroges /api/v1/images/task/[id] jusqu'à ce que l'image soit prête. Chaque réponse est en JSON — enveloppe de succès sur 2xx, enveloppe d'erreur avec un code stable et un request_id sur 4xx et 5xx. Chaque rendu est stocké sur notre CDN R2 et servi via HTTPS, donc tu peux utiliser l'URL en hotlink ou la recopier dans ton propre bucket. Les crédits sont débités de manière atomique à la soumission et automatiquement remboursés si une tâche échoue, donc ta facturation ne dérive jamais de ta production réelle. La surface est rattachée à l'utilisateur : les clés héritent du solde de crédits du compte propriétaire et ne voient que les tâches créées par programmation, jamais celles du studio web. Tout ce que tu envoies est en JSON — pas d'upload multipart, pas de lock-in SDK, pas de retries cachés.
POST /api/v1/images/generate gère à la fois le text-to-image et l'image-to-image pour la gpt-image-2 API. Les images de référence activent automatiquement le mode ; le reste du corps de requête reste identique.
Authentifie-toi avec Authorization: Bearer YOUR_API_KEY. La gpt-image-2 API rejette les clés en query string, donc tes tokens ne fuitent jamais dans les logs CDN ou proxy.
Chaque tâche gpt-image-2 API terminée renvoie une URL stable https://file.gptimg.co. Pas d'expiration d'URL signée, pas de boucle download-and-rehost, pas de lien temporaire.
La gpt-image-2 API couvre carré, portrait, paysage, widescreen et ultra-wide. Choisis le ratio dont ta plateforme a besoin et livre. Pas d'étape de letterboxing après la génération.
Si la gpt-image-2 API renvoie une tâche échouée, le débit de crédits est remboursé automatiquement. Tu n'as jamais besoin de construire un script de réconciliation.
Chaque réponse de la gpt-image-2 API, succès ou erreur, porte un header X-Request-Id et un request_id correspondant dans le corps. Les tickets de support se résolvent en minutes au lieu de jours.
Un endpoint de prompt, aucune infra à monter, une facturation que tu peux expliquer à la finance
Livre une nouvelle feature d'image sans provisionner de pods GPU ni négocier de contrat fournisseur. La gpt-image-2 API est un tarif forfaitaire par rendu — 2 crédits pour une image 1:1, linéaire sur la taille du batch. Branche un client dans ton backend avec un seul appel HTTP, pousse la feature derrière un flag, et laisse l'usage trouver ton prix. Les équipes passent de l'idée à la staging en moins d'un après-midi.
Image-to-image avec jusqu'à quatre références, le tout sur le même endpoint
Passe 1 à 4 URLs https dans reference_images et la gpt-image-2 API bascule automatiquement en mode image-to-image. Les équipes l'utilisent pour le style transfer, le restyle, le product swap et les éditions préservant l'identité. Pas d'endpoint d'édition séparé, pas de formulaire multipart, pas de bloat base64 — seules les URLs http(s) sont acceptées, donc tes corps de requête restent petits et tes logs restent lisibles.
Codes d'erreur stables, corrélation par request_id, messages sans fuite de provider
Chaque réponse de la gpt-image-2 API porte un request_id que tu peux citer dans les tickets de support. Les erreurs suivent une enveloppe uniforme avec les champs error.code, error.message et error.request_id. Un petit ensemble de codes stables couvre chaque mode de défaillance — UNAUTHORIZED, INVALID_REQUEST, INSUFFICIENT_CREDITS, NOT_FOUND, RATE_LIMITED, INTERNAL_ERROR. Les noms des providers en amont sont retirés de chaque message, donc tes clients ne voient jamais fuiter les internals fournisseur quand quelque chose casse.
Crédits à tarif forfaitaire, miroir R2 et une surface unique pour les deux modes
La gpt-image-2 API te donne un prix forfaitaire en crédits par rendu, des URLs PNG hébergées qui n'expirent pas en 24 heures, et un endpoint unique qui couvre text-to-image et image-to-image. La même image via l'endpoint images d'OpenAI coûte entre 0,01 $ et 0,20 $ selon la taille et la qualité, avec des URLs signées temporaires qu'il faut télécharger et réhéberger. Fais un batch n=4 et paie des crédits linéaires — pas d'endpoints séparés, pas de tarification cachée par palier de qualité, pas de licence par siège.
Quatre étapes. Premier curl en moins de cinq minutes.
Connecte-toi, ouvre Paramètres → Clés API, clique sur Créer, et copie la clé en clair une seule fois. La gpt-image-2 API n'affiche la clé qu'à la création — range-la dans un gestionnaire de secrets.
Envoie un JSON avec prompt, aspect_ratio, n et reference_images optionnel. La gpt-image-2 API renvoie immédiatement un task_id et un statut processing.
Attends dix secondes après la soumission, puis interroge toutes les cinq secondes jusqu'à ce que la gpt-image-2 API bascule le status à completed ou failed. La latence typique de bout en bout est de 45 à 60 secondes.
Les réponses terminées de la gpt-image-2 API contiennent une URL stable https://file.gptimg.co. Fais-en un hotlink, recopie-la sur ton stockage, ou envoie-la directement à ton frontend.
Intégration, tarifs et rate limits
La gpt-image-2 API arrive avec des crédits gratuits à l'inscription, un token Bearer en deux clics et un aller-retour de 45 secondes du prompt au PNG hébergé. Pas de SDK à installer, pas de carte bancaire pour démarrer.