Clave de API de GPT Image 2: acceso y primera solicitud

Sí, GPT Image 2 tiene API, y en SeedRouter una sola clave de API te da acceso a ella. Inicia sesión, crea una clave en la página de claves de API, añade créditos en la página de facturación y envía la clave en una cabecera Authorization: Bearer a https://api.seedrouter.ai/v1/images/generations. La clave solo se muestra completa una vez, cuando la creas, así que cópiala directamente en el entorno de tu servidor.

Los pasos siguientes te llevan de no tener cuenta a una imagen terminada, y cubren los cuatro errores que frenan la mayoría de las primeras solicitudes.

¿Cómo se obtiene una clave de API de GPT Image 2?

Inicia sesión en SeedRouter con tu cuenta de Google.
Abre claves de API y crea una clave. Dale un nombre que indique dónde se va a usar, como production-server.
Copia la clave de inmediato. Después de esta pantalla solo verás una versión enmascarada, y una clave perdida no se puede recuperar. En ese caso, revócala y crea una nueva.
Añade créditos en la página de facturación. Una clave funciona en cuanto existe, pero una solicitud necesita créditos para ejecutarse.

Una sola clave sirve para todos los modelos de SeedRouter, así que no necesitas una clave aparte para GPT Image 2 y GPT Image 2.5. En su lugar, crea claves separadas por entorno. Así, revocar la clave de staging no puede romper producción.

¿Dónde debe guardarse la clave de API?

En tu servidor, en una variable de entorno, y en ningún otro sitio:

export SEEDROUTER_API_KEY="your-key"

Nunca pongas la clave en JavaScript del navegador, en el paquete de una app móvil ni en un repositorio público. Cualquiera que la lea puede gastar tus créditos. Si tu producto tiene front end, haz que llame a tu propio back end y deja que sea el back end quien llame a la API con la clave.

Si una clave se filtra, revócala de inmediato en la página de claves de API. Una clave revocada deja de funcionar y las solicitudes que la usan se rechazan.

¿Cómo se hace la primera solicitud con la clave?

Envía la clave como bearer token. La respuesta es una referencia a una tarea, no la imagen:

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"
  }'

Guarda el id de la respuesta y sondea GET https://api.seedrouter.ai/v1/tasks/{id} con la misma cabecera hasta que status sea completed. La tarea terminada incluye las URL de las imágenes. Para ver un bucle completo en código, consulta la API de GPT Image 2 en Python.

Dos IDs de modelo sirven GPT Image 2 con los mismos campos: gpt-image-2 cobra un precio fijo por imagen entregada y gpt-image-2-official factura los tokens que reporta cada render. La clave funciona con ambos. Los precios actuales están en la página del modelo.

¿Qué errores suele encontrar una clave de API nueva?

Código de error	HTTP	Qué significa	Qué hacer
`10001`	401	La clave falta, está mal escrita o fue revocada	Envía la clave completa en la cabecera `Authorization`
`20002`	400	El valor de `model` no es un ID disponible	Usa exactamente `gpt-image-2` o `gpt-image-2-official`
`20001`	400	Un campo es incorrecto; el mensaje lo nombra cuando puede	Corrige ese campo antes de reintentar
`30001`	402	La cuenta no tiene créditos	Añade créditos y vuelve a enviar

Dos descuidos causan la mayoría de los fallos en la primera solicitud. Uno es pegar la clave con un carácter de menos o un espacio de más, lo que devuelve 10001. El otro es copiar el nombre del modelo de un titular, como gpt-image-2.0 o GPT Image 2, en lugar del ID de modelo, lo que devuelve 20002. Ambos se rechazan antes de que empiece cualquier trabajo, así que no se cobra nada.

¿Existe una clave de API de GPT Image 2 gratis?

No. Crear una clave es gratis, pero las solicitudes se pagan con créditos prepagados. Lo que no pagas es el fallo: una tarea que termina en failed, o que no devuelve ninguna imagen, no cuesta nada. Los créditos se compran con recargas únicas, nunca caducan y no implican suscripción, así que una primera recarga pequeña basta para probar bien una integración.

¿Se puede usar una misma clave desde Python y JavaScript?

Sí. La clave es una cadena en una cabecera HTTP, así que cualquier lenguaje que pueda enviar una solicitud HTTP puede usarla. Léela del entorno en cada runtime: os.environ["SEEDROUTER_API_KEY"] en Python y process.env.SEEDROUTER_API_KEY en Node.js. Mantén el JavaScript en el lado del servidor; la misma clave en código del navegador queda expuesta a todos los visitantes.

Preguntas frecuentes

¿Necesito una clave de API de OpenAI para usar GPT Image 2 aquí?

No. Tu clave de SeedRouter es la única credencial que envías. No tienes que crear ni gestionar una cuenta aparte en otro sitio para llamar a GPT Image 2 a través de esta API.

¿Cuántas claves de API puedo crear?

Las suficientes para tener una por servidor o servicio; el límite por cuenta está muy por encima de lo que necesita una integración. Cada clave se puede revocar por separado.

¿Dónde veo lo que ha gastado una clave?

En el historial de uso. Cada solicitud muestra su modelo y su cargo, lo que facilita comparar una integración nueva con tu estimación.

Mantén la clave en el servidor y lanza

Crea una clave por entorno, guárdala en una variable de entorno y envíala como bearer token solo desde tu back end. Cuando la primera solicitud devuelve un id de tarea, la parte del acceso está resuelta; todo lo demás está en la referencia de la API de GPT Image 2.

Clave de API de GPT Image 2: cómo obtener acceso y hacer la primera solicitud