Usa GPT Image 2 en Codex, Claude Code y otros agentes de programación

Un agente de programación como Codex o Claude Code puede generar imágenes de GPT Image 2 llamando directamente a la API. Pon tu clave de API en una variable de entorno, dale al agente el prompt de abajo y construirá la solicitud, te la mostrará, la enviará cuando la apruebes, sondeará la tarea y guardará las imágenes en tu proyecto. No hace falta ningún plugin: un agente que pueda ejecutar un comando de shell o un script corto puede llamar a la API.

SeedRouter no ofrece un servidor MCP ni una skill empaquetada. El prompt de esta guía es toda la integración. Puedes guardarlo como instrucción reutilizable en el agente que uses.

¿Qué necesita el agente antes de empezar?

Tres cosas:

1. Una clave de API en el entorno. Crea una en la página de claves de API y expórtala en la shell donde se ejecuta el agente. El agente la lee de ahí; nunca debería pedirte que la pegues.
2. Acceso a la red. El agente llama a https://api.seedrouter.ai, así que su sandbox debe permitir solicitudes salientes para esta tarea.
3. Créditos. Las solicitudes se pagan con tu saldo, así que recarga antes de la primera ejecución.

export SEEDROUTER_API_KEY="your-key"

¿Qué prompt debes darle al agente?

Pega esto al principio de la tarea y rellena el objetivo entre corchetes. Enumera los campos exactos que acepta la API, para que el agente no se invente parámetros, y lo obliga a detenerse y esperar tu aprobación antes de que se cobre nada:

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.

El paso de aprobación es el más importante. Un agente que reintenta por su cuenta puede enviar la misma solicitud de pago varias veces. Mantén esa instrucción aunque ya confíes en la configuración.

¿Cómo se usa en Codex?

Abre Codex en tu proyecto y pega el prompt con tu objetivo rellenado. Para reutilizarlo, añade el prompt al AGENTS.md del proyecto, el archivo de instrucciones que Codex lee para el repositorio, bajo un encabezado como "Generating images". A partir de ahí basta con una petición como "haz una imagen principal para la página de precios"; Codex sigue los pasos guardados.

Si Codex se ejecuta en un sandbox sin acceso a la red, no puede llegar a la API. Permite el acceso a la red en esa sesión antes de pedirle que genere.

¿Cómo se usa en Claude Code?

El mismo prompt funciona en Claude Code. Para reutilizarlo, guárdalo en el CLAUDE.md del proyecto o como skill: una carpeta con un archivo SKILL.md cuyas instrucciones contengan el prompt. Claude Code la cargará cuando pidas una imagen. Asegúrate de que SEEDROUTER_API_KEY esté exportada en la terminal desde la que inicias Claude Code.

¿Cómo es una buena ejecución del agente?

1. Describes la imagen y dónde debe ir.
2. El agente muestra el ID de modelo, el cuerpo exacto de la solicitud y un coste estimado, y espera.
3. Tú apruebas. El agente envía una sola vez e informa del ID de la tarea.
4. Sondea hasta que la tarea se completa, descarga las imágenes en el proyecto y te indica las rutas de los archivos.

Si una ejecución se detiene a medias, el ID de la tarea sigue siendo válido. Pide al agente que reanude el sondeo de ese ID en lugar de generar de nuevo; un segundo envío es un segundo cobro. Una tarea que termina en failed no se cobra.

Preguntas frecuentes

¿SeedRouter tiene un servidor MCP o una skill para GPT Image 2?

No. La propia API es la integración, y el prompt de arriba le da a un agente todo lo que necesita para llamarla. Guarda el prompt como skill o archivo de instrucciones en tu propio agente si quieres reutilizarlo.

¿Puede el agente editar imágenes que ya están en mi proyecto?

Sí, si las imágenes son accesibles en URL HTTPS públicas. La API recibe las imágenes de referencia y las máscaras como URL, no como archivos locales, así que súbelas primero o dile al agente dónde están alojadas.

¿Qué modelo debe usar el agente?

gpt-image-2 para pagar un precio fijo por imagen entregada, o gpt-image-2-official para pagar por los tokens que reporta cada render. Cambia el modelo en el prompt para alternar. Los precios actuales están en la página del modelo.

Mantén a una persona en el circuito

Dale al agente la clave a través del entorno, los campos a través del prompt y la última palabra a través del paso de aprobación. Esa combinación permite que Codex o Claude Code produzcan imágenes dentro de tu proyecto sin cobros inesperados. La referencia de la API de GPT Image 2 tiene todos los campos si quieres ampliar el prompt.