Clé API GPT Image 2 : obtenir l’accès et première requête

Oui, GPT Image 2 dispose d’une API, et sur SeedRouter une seule clé API vous y donne accès. Connectez-vous, créez une clé sur la page Clés API, ajoutez des crédits sur la page de facturation, puis envoyez la clé dans un en-tête Authorization: Bearer à https://api.seedrouter.ai/v1/images/generations. La clé n’est affichée en entier qu’une seule fois, au moment de sa création : copiez-la directement dans l’environnement de votre serveur.

Les étapes ci-dessous vous mènent de l’absence de compte à une image terminée, et couvrent les quatre erreurs qui bloquent la plupart des premières requêtes.

Comment obtenir une clé API GPT Image 2 ?

Connectez-vous à SeedRouter avec votre compte Google.
Ouvrez Clés API et créez une clé. Donnez-lui un nom qui indique où elle sera utilisée, par exemple production-server.
Copiez la clé immédiatement. Après cet écran, vous ne voyez plus qu’une version masquée, et une clé perdue ne peut pas être récupérée. Révoquez-la et créez-en une nouvelle à la place.
Ajoutez des crédits sur la page de facturation. Une clé fonctionne dès sa création, mais une requête a besoin de crédits pour s’exécuter.

Une seule clé donne accès à tous les modèles de SeedRouter : vous n’avez pas besoin d’une clé distincte pour GPT Image 2 et GPT Image 2.5. Créez plutôt une clé par environnement. Révoquer la clé de préproduction ne peut alors pas casser la production.

Où stocker la clé API ?

Sur votre serveur, dans une variable d’environnement, et nulle part ailleurs :

export SEEDROUTER_API_KEY="your-key"

Ne placez jamais la clé dans du JavaScript côté navigateur, dans le paquet d’une application mobile ou dans un dépôt public. Quiconque la lit peut dépenser vos crédits. Si votre produit a un front-end, faites-lui appeler votre propre back-end, et laissez le back-end appeler l’API avec la clé.

Si une clé fuite malgré tout, révoquez-la immédiatement sur la page Clés API. Une clé révoquée cesse de fonctionner, et les requêtes qui l’utilisent sont rejetées.

Comment envoyer une première requête avec la clé ?

Envoyez la clé comme jeton bearer. La réponse est une référence de tâche, pas l’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",
    "prompt": "An amber glass bottle on a cream background, studio lighting",
    "size": "1024x1024",
    "quality": "low"
  }'

Conservez l’id de la réponse et interrogez GET https://api.seedrouter.ai/v1/tasks/{id} avec le même en-tête jusqu’à ce que status vaille completed. La tâche terminée liste les URL des images. Pour une boucle complète en code, consultez l’API GPT Image 2 en Python.

Deux ID de modèle servent GPT Image 2 avec les mêmes champs : gpt-image-2 facture un prix fixe par image livrée, et gpt-image-2-official facture les tokens déclarés par chaque rendu. La clé fonctionne avec les deux. Les prix actuels figurent sur la page du modèle.

Quelles erreurs une nouvelle clé API rencontre-t-elle le plus souvent ?

Code d’erreur	HTTP	Signification	Que faire
`10001`	401	La clé est absente, mal saisie ou révoquée	Envoyez la clé complète dans l’en-tête `Authorization`
`20002`	400	La valeur de `model` n’est pas un ID servi	Utilisez exactement `gpt-image-2` ou `gpt-image-2-official`
`20001`	400	Un champ est incorrect ; le message le nomme quand c’est possible	Corrigez ce champ avant de réessayer
`30001`	402	Le compte n’a plus de crédits	Ajoutez des crédits, puis renvoyez la requête

Deux erreurs d’inattention expliquent la plupart des échecs de première requête. La première est une clé collée avec un caractère manquant ou une espace en trop, qui renvoie 10001. La seconde consiste à copier le nom du modèle depuis un titre, comme gpt-image-2.0 ou GPT Image 2, au lieu de l’ID de modèle, ce qui renvoie 20002. Les deux sont rejetées avant le début de tout traitement : rien n’est facturé.

Existe-t-il une clé API GPT Image 2 gratuite ?

Non. La création d’une clé est gratuite, mais les requêtes sont payées avec des crédits prépayés. Ce que vous ne payez pas, c’est l’échec : une tâche qui se termine en failed, ou qui ne renvoie aucune image, ne coûte rien. Les crédits s’achètent par recharges ponctuelles, n’expirent jamais et n’impliquent aucun abonnement : une petite première recharge suffit pour tester correctement une intégration.

Peut-on utiliser une même clé en Python et en JavaScript ?

Oui. La clé est une chaîne dans un en-tête HTTP : tout langage capable d’envoyer une requête HTTP peut l’utiliser. Lisez-la depuis l’environnement dans chaque runtime : os.environ["SEEDROUTER_API_KEY"] en Python et process.env.SEEDROUTER_API_KEY en Node.js. Gardez le JavaScript côté serveur ; la même clé placée dans du code navigateur est exposée à chaque visiteur.

Questions fréquentes

Ai-je besoin d’une clé API OpenAI pour utiliser GPT Image 2 ici ?

Non. Votre clé SeedRouter est le seul identifiant que vous envoyez. Vous n’avez pas à créer ni à gérer un compte séparé ailleurs pour appeler GPT Image 2 via cette API.

Combien de clés API puis-je créer ?

Assez pour en avoir une par serveur ou par service ; la limite par compte est bien au-dessus des besoins d’une intégration. Chaque clé peut être révoquée séparément.

Où voir ce qu’une clé a dépensé ?

Dans l’historique d’utilisation. Chaque requête indique son modèle et son montant, ce qui permet de comparer facilement une nouvelle intégration à votre estimation.

Gardez la clé sur le serveur et lancez-vous

Créez une clé par environnement, stockez-la dans une variable d’environnement et envoyez-la comme jeton bearer depuis votre back-end uniquement. Quand la première requête renvoie un id de tâche, la partie accès est terminée ; tout le reste se trouve dans la référence de l’API GPT Image 2.

Clé API GPT Image 2 : obtenir l’accès et envoyer une première requête