Use o GPT Image 2 no Codex, no Claude Code e em outros agentes de código

Um agente de código como o Codex ou o Claude Code pode gerar imagens com o GPT Image 2 chamando a API diretamente. Coloque sua chave de API em uma variável de ambiente, entregue ao agente o prompt abaixo, e ele monta a requisição, mostra para você, envia depois da sua aprovação, consulta a tarefa e salva as imagens no seu projeto. Não é preciso plugin: um agente que consegue rodar um comando de shell ou um script curto consegue chamar a API.

A SeedRouter não oferece servidor MCP nem skill empacotada. O prompt deste guia é a integração inteira. Você pode salvá-lo como instrução reutilizável em qualquer agente que usar.

Do que o agente precisa antes de começar?

Três coisas:

1. Uma chave de API no ambiente. Crie uma na página de chaves de API e exporte-a no shell em que o agente roda. O agente a lê de lá; ele nunca deve pedir que você a cole.
2. Acesso à rede. O agente chama https://api.seedrouter.ai, então o sandbox dele precisa permitir requisições de saída para esta tarefa.
3. Créditos. As requisições são pagas com o seu saldo, então faça uma recarga antes da primeira execução.

export SEEDROUTER_API_KEY="your-key"

Qual prompt entregar ao agente?

Cole isto no início da tarefa e depois preencha o objetivo entre colchetes. O prompt lista os campos exatos que a API aceita, para que o agente não invente parâmetros, e faz o agente parar para pedir sua aprovação antes de qualquer cobrança:

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.

O passo de aprovação é o mais importante. Um agente que tenta de novo por conta própria pode enviar a mesma requisição paga várias vezes. Mantenha essa instrução mesmo depois de confiar na configuração.

Como usar no Codex?

Abra o Codex no seu projeto e cole o prompt com o objetivo preenchido. Para reutilizá-lo, adicione o prompt ao AGENTS.md do projeto, o arquivo de instruções que o Codex lê no repositório, sob um título como "Generating images". Aí um pedido como "crie uma imagem de destaque para a página de preços" basta; o Codex segue os passos salvos.

Se o Codex rodar em um sandbox sem acesso à rede, ele não alcança a API. Libere o acesso à rede nessa sessão antes de pedir a geração.

Como usar no Claude Code?

O mesmo prompt funciona no Claude Code. Para reutilizar, salve-o no CLAUDE.md do projeto ou como skill: uma pasta com um arquivo SKILL.md cujas instruções contêm o prompt. O Claude Code então o carrega quando você pede uma imagem. Confira se SEEDROUTER_API_KEY está exportada no terminal em que você inicia o Claude Code.

Como é uma boa execução do agente?

1. Você descreve a imagem e onde ela deve entrar.
2. O agente mostra o ID do modelo, o corpo exato da requisição e um custo estimado, e espera.
3. Você aprova. O agente envia uma única vez e informa o ID da tarefa.
4. Ele consulta até a tarefa terminar, baixa as imagens para o projeto e informa os caminhos dos arquivos.

Se uma execução parar no meio, o ID da tarefa continua válido. Peça ao agente para retomar o polling desse ID em vez de gerar de novo; um segundo envio é uma segunda cobrança. Uma tarefa que termina como failed não é cobrada.

Perguntas frequentes

A SeedRouter tem servidor MCP ou skill para o GPT Image 2?

Não. A própria API é a integração, e o prompt acima dá ao agente tudo de que ele precisa para chamá-la. Salve o prompt como skill ou arquivo de instruções no seu próprio agente se quiser reutilizá-lo.

O agente pode editar imagens que já estão no meu projeto?

Sim, se as imagens estiverem acessíveis em URLs HTTPS públicas. A API recebe imagens de referência e máscaras como URLs, não como arquivos locais, então suba-as antes ou diga ao agente onde estão hospedadas.

Qual modelo o agente deve usar?

gpt-image-2 para um preço fixo por imagem entregue, ou gpt-image-2-official para pagar pelos tokens que cada renderização informa. Troque o modelo no prompt para alternar. Os preços atuais estão na página do modelo.

Mantenha uma pessoa no controle

Entregue ao agente a chave pelo ambiente, os campos pelo prompt e a palavra final pelo passo de aprovação. Essa combinação permite que o Codex ou o Claude Code produzam imagens dentro do seu projeto sem cobranças surpresa. A referência da API do GPT Image 2 traz todos os campos, caso você queira ampliar o prompt.