Utiliser GPT Image 2 dans Codex, Claude Code et d’autres agents de code

Un agent de code comme Codex ou Claude Code peut générer des images GPT Image 2 en appelant directement l’API. Placez votre clé API dans une variable d’environnement, donnez à l’agent le prompt ci-dessous : il construira la requête, vous la montrera, l’enverra après votre approbation, interrogera la tâche et enregistrera les images dans votre projet. Aucun plugin n’est nécessaire : un agent capable d’exécuter une commande shell ou un court script peut appeler l’API.

SeedRouter ne fournit ni serveur MCP ni skill packagé. Le prompt de ce guide constitue toute l’intégration. Vous pouvez l’enregistrer comme instruction réutilisable dans l’agent que vous utilisez.

De quoi l’agent a-t-il besoin avant de commencer ?

Trois choses :

1. Une clé API dans l’environnement. Créez-en une sur la page Clés API et exportez-la dans le shell où tourne l’agent. L’agent la lit à cet endroit ; il ne doit jamais vous demander de la coller.
2. Un accès réseau. L’agent appelle https://api.seedrouter.ai : son bac à sable doit donc autoriser les requêtes sortantes pour cette tâche.
3. Des crédits. Les requêtes sont payées sur votre solde : rechargez avant la première exécution.

export SEEDROUTER_API_KEY="your-key"

Quel prompt donner à l’agent ?

Collez ceci au début de la tâche, puis complétez l’objectif entre crochets. Le prompt liste les champs exacts que l’API accepte, pour que l’agent n’invente pas de paramètres, et il oblige l’agent à attendre votre approbation avant toute facturation :

Use the SeedRouter API to generate a gpt-image-2 image for me.

Security: read SEEDROUTER_API_KEY from my local environment. Never ask me to paste it and never expose it in code, prompts, logs, or output.

Goal:
- Use case: [product / social / concept art / UI mockup]
- Subject and style: [subject, composition, lighting, style]
- Size: [auto | 1024x1024 | 1536x1024 | 1024x1536 | WIDTHxHEIGHT]
- Quality: [auto | low | medium | high]
- Number of images: [1-10]
- Acceptance criteria: [e.g. no text in the image, consistent product, clean background]

Request fields this endpoint accepts, and nothing else:
  model (required, "gpt-image-2"), prompt (required, up to 32000 chars),
  n (1-10, default 1), size (default auto; a custom WIDTHxHEIGHT must have
  both sides divisible by 16, neither edge over 3840, total pixels between
  655360 and 8294400, and keep a ratio between
  1:3 and 3:1), quality (auto|low|medium|high, default auto),
  background (auto|opaque|transparent, default auto; transparent requires
  output_format png), output_format (png|jpeg, default png),
  output_compression (0-100, default 100, jpeg only),
  moderation (auto|low, default auto), user (your own identifier).
For editing use /v1/images/generations with images: [{image_url: "https://..."}]
(up to 16) and optional mask: {image_url: "https://..."}. Mask requires images.
Inputs must be URLs, not base64 or multipart files. stream and partial_images
are not supported because delivery is asynchronous.

Before any paid request, show me the model id, the exact request body and the
estimated cost, then wait for my explicit approval.

After approval:
1. POST https://api.seedrouter.ai/v1/images/generations with the body above and
   an Authorization: Bearer $SEEDROUTER_API_KEY header.
2. Save the task id from the response "id" field. The response is
   {"id": "...", "status": "processing"} — the image is not in it.
3. Poll https://api.seedrouter.ai/v1/tasks/{task_id} with the same header every
   5-10 seconds until status is "completed" or "failed". Do not retry forever;
   if you stop waiting, preserve the task id and report that it is still pending.
   A polling timeout is not a failed task. Never submit a duplicate just to check status.
4. On success, download every URL in output.data[].url, return the local paths,
   the task id, and the parameters used. The response carries no cost field.
5. On failure, keep the task id, explain the reason and what to change, and do
   not retry without my approval. A task that ends failed is not charged.

L’étape d’approbation est la plus importante. Un agent qui réessaie de lui-même peut envoyer plusieurs fois la même requête payante. Gardez cette instruction en place, même une fois que vous faites confiance à la configuration.

Comment l’utiliser dans Codex ?

Ouvrez Codex dans votre projet et collez le prompt avec votre objectif complété. Pour le réutiliser, ajoutez le prompt au fichier AGENTS.md du projet, le fichier d’instructions que Codex lit pour le dépôt, sous un titre comme « Generating images ». Une demande comme « crée une image d’en-tête pour la page des tarifs » suffit alors ; Codex suit les étapes enregistrées.

Si Codex tourne dans un bac à sable sans accès réseau, il ne peut pas joindre l’API. Autorisez l’accès réseau pour cette session avant de lui demander de générer.

Comment l’utiliser dans Claude Code ?

Le même prompt fonctionne dans Claude Code. Pour le réutiliser, enregistrez-le dans le fichier CLAUDE.md du projet, ou sous forme de skill : un dossier avec un fichier SKILL.md dont les instructions contiennent le prompt. Claude Code le charge alors quand vous demandez une image. Vérifiez que SEEDROUTER_API_KEY est exporté dans le terminal depuis lequel vous lancez Claude Code.

À quoi ressemble une bonne exécution de l’agent ?

1. Vous décrivez l’image et l’endroit où elle doit aller.
2. L’agent affiche l’ID de modèle, le corps exact de la requête et un coût estimé, puis attend.
3. Vous approuvez. L’agent envoie la requête une seule fois et indique l’ID de tâche.
4. Il interroge la tâche jusqu’à ce qu’elle se termine, télécharge les images dans le projet et vous donne les chemins des fichiers.

Si une exécution s’arrête en cours de route, l’ID de tâche reste valide. Demandez à l’agent de reprendre l’interrogation de cet ID au lieu de générer à nouveau ; un second envoi est une seconde facturation. Une tâche qui se termine en échec n’est pas facturée.

Questions fréquentes

SeedRouter propose-t-il un serveur MCP ou un skill GPT Image 2 ?

Non. L’API elle-même est l’intégration, et le prompt ci-dessus donne à un agent tout ce dont il a besoin pour l’appeler. Enregistrez le prompt comme skill ou fichier d’instructions dans votre propre agent si vous voulez le réutiliser.

L’agent peut-il retoucher des images existantes de mon projet ?

Oui, si les images sont accessibles via des URL HTTPS publiques. L’API reçoit les images de référence et les masques sous forme d’URL, pas de fichiers locaux : téléversez-les d’abord ou indiquez à l’agent où elles sont hébergées.

Quel modèle l’agent doit-il utiliser ?

gpt-image-2 pour un prix fixe par image livrée, ou gpt-image-2-official pour payer selon les tokens déclarés par chaque rendu. Remplacez le modèle dans le prompt pour changer. Les prix actuels figurent sur la page du modèle.

Gardez l’humain dans la boucle

Donnez à l’agent la clé via l’environnement, les champs via le prompt, et le dernier mot via l’étape d’approbation. Cette combinaison permet à Codex ou à Claude Code de produire des images dans votre projet sans facturation surprise. La référence de l’API GPT Image 2 contient chaque champ si vous voulez enrichir le prompt.