GPT Image 2 : votre première requête à l'Image API

Ce qu'il vous faut

• curl pour envoyer la requête ;
• votre propre API Key BetterToken ;
• la Base URL exacte https://www.bettertoken.ai/v1 ;
• le modèle gpt-image-2 pour cette Image API ;
• un décodeur Base64 ou un court script Python.

N'insérez pas de vraie clé dans le code source, les captures d'écran ou une commande qui restera dans l'historique du shell. Stockez-la dans une variable d'environnement :

export BETTERTOKEN_API_KEY="your_api_key_here"

La valeur ci-dessus est un simple espace réservé. Utilisez votre propre clé et ne la publiez jamais.

Votre première requête GPT Image 2

Envoyez une requête à l'endpoint de génération d'images :

curl https://www.bettertoken.ai/v1/images/generations \
  -H "Authorization: Bearer $BETTERTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean editorial illustration of a coding desk at night, green and graphite palette"
  }' \
  -o image-response.json

Si la requête réussit, image-response.json contient un objet data. L'image se trouve dans data[0].b64_json. Ce format de réponse convient aux flux côté serveur : vous pouvez stocker le payload dans un stockage d'objets, le transmettre à l'étape suivante ou le décoder directement dans un fichier local.

Enregistrer l'image

L'exemple suivant lit le JSON, décode la valeur Base64 et crée bettertoken-image.png. Il utilise uniquement la bibliothèque standard de Python :

import base64
import json

with open("image-response.json", "r", encoding="utf-8") as source:
    payload = json.load(source)

image_base64 = payload["data"][0]["b64_json"]

with open("bettertoken-image.png", "wb") as target:
    target.write(base64.b64decode(image_base64))

print("Saved: bettertoken-image.png")

Ouvrez le fichier et vérifiez qu'il correspond au prompt. Un HTTP 200 confirme que la requête a fonctionné, mais ne remplace pas un contrôle visuel du résultat.

Améliorer la deuxième requête

Pour le premier test, utilisez un prompt court en quatre parties claires :

1. sujet ou scène ;
2. style visuel ;
3. composition ;
4. palette ou éclairage.

Par exemple :

Editorial illustration of a developer reviewing an API response,
clean geometric style, centered composition, dark graphite background
with restrained green accents, no text, no logos

Ne commencez pas par une longue liste d'exigences contradictoires. Vérifiez d'abord la composition de base, puis modifiez un seul paramètre à la fois. Il sera ainsi plus facile de déterminer quelle formulation a influé sur le résultat.

Erreurs courantes

401 : clé refusée

Vérifiez que BETTERTOKEN_API_KEY est défini dans le terminal actuel et que l'en-tête d'autorisation contient le préfixe Bearer. N'affichez pas la clé avec echo et n'envoyez pas sa valeur complète au support.

402 ou solde insuffisant

Ouvrez le Dashboard BetterToken et vérifiez le solde disponible. Le solde BetterToken payé ne revient pas automatiquement à zéro à la fin du mois, mais chaque requête exige toujours un solde restant suffisant.

404 : chemin incorrect

La génération d'images utilise ce chemin complet :

https://www.bettertoken.ai/v1/images/generations

Ne le remplacez pas par l'endpoint Chat Completions et n'utilisez pas api.openai.com : une clé BetterToken fonctionne avec l'endpoint BetterToken.

400 : modèle ou paramètres incorrects

Commencez uniquement avec les champs requis model et prompt. Ce guide utilise gpt-image-2. Si l'API indique que le modèle n'est pas disponible, comparez le Model ID et les paramètres actuels avec la documentation Image API.

429 ou 5xx

Ne lancez pas de boucle de nouvelles tentatives infinie. Notez le statut HTTP, l'heure de la requête et une partie sûre de la réponse, puis réessayez après un délai. Dans le Dashboard BetterToken, vous pouvez rapprocher la requête par l'heure et examiner le modèle, le statut, l'usage des tokens d'entrée/sortie/cache et le débit, sans voir le prompt complet.

Vérifications avant l'intégration dans une application

Avant de transférer la requête vers un backend ou un flux d'automatisation, confirmez que :

• la clé est stockée dans une variable d'environnement ou un gestionnaire de secrets ;
• la requête va vers BetterToken et non vers l'endpoint d'un autre fournisseur ;
• le modèle et les paramètres proviennent de la documentation actuelle ;
• le payload Base64 se décode sans erreur ;
• l'application limite les tentatives et traite les réponses non-2xx ;
• le coût est vérifié avec la page de tarifs actuelle, et non avec un ancien comparatif.

Vous pouvez alors reporter le même contrat dans le SDK ou le client HTTP de votre application. Commencez par la requête minimale, enregistrez un résultat, puis ajoutez seulement ensuite les dimensions, réglages de qualité, traitements par lots et votre propre couche de stockage.

En bref

Le premier flux fonctionnel comporte trois étapes : envoyer une requête POST à la BetterToken Image API, lire data[0].b64_json et le décoder dans un fichier. Si vous avez besoin de votre propre clé et d'une facturation à l'usage, créez un compte BetterToken et vérifiez les paramètres et les tarifs actuels avant d'exécuter la requête.