Llama a la gpt-image-2 API con un token Bearer y recibe un PNG alojado en unos 45 segundos. Texto-a-imagen e imagen-a-imagen comparten el mismo endpoint. 2 créditos por imagen, sin cuota fija, sin instalar SDK. Crea una key y lanza tu primer curl antes de que llegue el café.
Usada por 10.000+ desarrolladores que envían con la gpt-image-2 API
Un endpoint. Auth Bearer. Salida alojada. Nada más que conectar.
La gpt-image-2 API es una superficie REST que convierte un prompt (y hasta cuatro imágenes de referencia) en un PNG listo para producción. Haces POST a /api/v1/images/generate con un token Bearer, recibes un task_id y consultas /api/v1/images/task/[id] hasta que la imagen esté lista. Toda respuesta es JSON: envelope de éxito en 2xx, envelope de error con código estable y request_id en 4xx y 5xx. Cada render se guarda en nuestro CDN R2 y se sirve por HTTPS, así puedes enlazar la URL directamente o espejarla a tu propio bucket. Los créditos se descuentan de forma atómica al enviar y se reembolsan automáticamente si una tarea falla, así tu facturación nunca se separa de la salida real. La superficie es por usuario: las keys heredan el saldo de créditos de la cuenta dueña y solo ven tareas creadas programáticamente, no las del studio web. Todo lo que envías es JSON: sin uploads multipart, sin lock-in de SDK, sin reintentos ocultos.
POST /api/v1/images/generate cubre tanto texto-a-imagen como imagen-a-imagen en la gpt-image-2 API. Las imágenes de referencia cambian el modo automáticamente; el resto del body se mantiene idéntico.
Autentica con Authorization: Bearer YOUR_API_KEY. La gpt-image-2 API rechaza keys en query strings, así tus tokens nunca se filtran en logs de CDN o proxy.
Cada tarea completada por la gpt-image-2 API devuelve una URL estable en https://file.gptimg.co. Sin caducidad de signed URL, sin bucle de descarga y rehospedaje, sin enlaces temporales.
La gpt-image-2 API cubre cuadrado, retrato, paisaje, panorámico y ultraancho. Elige el ratio que tu plataforma necesita y envía. Sin paso de letterbox tras la generación.
Si la gpt-image-2 API devuelve una tarea failed, el cargo en créditos se reembolsa automáticamente. Nunca necesitas construir un script de reconciliación.
Cada respuesta de la gpt-image-2 API, de éxito o error, lleva un header X-Request-Id y un request_id coincidente en el body. Los tickets de soporte se resuelven en minutos en lugar de días.
Un endpoint de prompt, sin infra que montar, una facturación que le puedes explicar a finanzas
Lanza una nueva feature de imagen sin aprovisionar pods de GPU ni negociar contratos con proveedores. La gpt-image-2 API es una tarifa plana por render: 2 créditos por una imagen 1:1, lineal por tamaño de batch. Mete un cliente en tu backend con una sola llamada HTTP, lanza la feature detrás de un flag y deja que el uso encuentre tu punto de precio. Los equipos pasan de idea a staging en menos de una tarde.
Imagen-a-imagen con hasta cuatro referencias, todo por el mismo endpoint
Pasa de 1 a 4 URLs https en reference_images y la gpt-image-2 API cambia automáticamente a modo imagen-a-imagen. Los equipos la usan para transferencia de estilo, restyle, cambio de producto y ediciones que preservan la identidad. Sin endpoint de edición aparte, sin form multipart, sin bloat de base64: solo se aceptan URLs http(s), así tus bodies de request se mantienen pequeños y tus logs legibles.
Códigos de error estables, correlación por request_id, mensajes con proveedor oculto
Cada respuesta de la gpt-image-2 API lleva un request_id que puedes citar en tickets de soporte. Los errores siguen un envelope uniforme con campos error.code, error.message y error.request_id. Un conjunto pequeño de códigos estables cubre cada fallo: UNAUTHORIZED, INVALID_REQUEST, INSUFFICIENT_CREDITS, NOT_FOUND, RATE_LIMITED, INTERNAL_ERROR. Los nombres de proveedores upstream se limpian de cada mensaje, así tus clientes nunca ven internals de vendor filtrados cuando algo falla.
Créditos a tarifa plana, espejado en R2 y una única superficie para ambos modos
La gpt-image-2 API te da un precio en créditos plano por render, URLs de PNG alojado que no caducan en 24 horas y un solo endpoint que cubre texto-a-imagen e imagen-a-imagen. La misma imagen por el endpoint de images de OpenAI cuesta entre 0,01 y 0,20 dólares según tamaño y calidad, con signed URLs temporales que tienes que descargar y rehospedar. Haz batch con n=4 y paga créditos lineales: sin endpoints aparte, sin pricing oculto por tier de calidad, sin licencias por asiento.
Cuatro pasos. Primer curl en menos de cinco minutos.
Inicia sesión, abre Settings → API Keys, pulsa Create y copia la key en texto plano una vez. La gpt-image-2 API solo muestra la key al crearla: guárdala en un gestor de secretos.
Envía JSON con prompt, aspect_ratio, n y reference_images opcionales. La gpt-image-2 API devuelve un task_id y un estado processing de inmediato.
Espera diez segundos tras el envío y luego consulta cada cinco segundos hasta que la gpt-image-2 API pase status a completed o failed. La latencia típica extremo a extremo es de 45 a 60 segundos.
Las respuestas completed de la gpt-image-2 API contienen una URL estable en https://file.gptimg.co. Enlázala directamente, espéjala a tu almacenamiento o pásala tal cual a tu frontend.
Integración, precios y rate limits
La gpt-image-2 API viene con créditos gratis al registrarte, un token Bearer en dos clics y un round trip de 45 segundos de prompt a PNG alojado. Sin instalar SDK, sin tarjeta para empezar.