Saltar al contenido principal

Guía de GPT-Image-2 API: Image API, Responses, precios y la 2.5

gpt-image-2 sigue activo, pero OpenAI recomienda GPT Image 2.5 para integraciones nuevas; los tres modelos cobran igual por token y no tienen capa gratuita.

LaoZhang AI TeamPublicadoActualizado 12 min de lectura
En esta página
Dos rutas para integrar GPT Image 2 API

A 10 de octubre de 2026, gpt-image-2 sigue funcionando y no figura en la lista de modelos obsoletos de OpenAI, pero ya no es la recomendación para empezar. La guía de generación de imágenes de OpenAI dice: «For new integrations, use one of the GPT Image 2.5 models». Esos modelos son gpt-image-2.5-sunburst, pensado para cuando la precisión en la edición es lo que más importa, y gpt-image-2.5-flare, para generar imágenes de calidad a diario y con rapidez.

Las dos formas de llamar a cualquiera de los tres siguen siendo las mismas: la Image API, si la imagen es el resultado final, y la herramienta image_generation de Responses, si la imagen forma parte de una conversación o de un agente.

Respuesta rápida

PreguntaRespuesta a 10 de octubre de 2026
¿Qué modelo uso en una integración nueva?gpt-image-2.5-sunburst para editar con precisión; gpt-image-2.5-flare para generar rápido. gpt-image-2 (snapshot gpt-image-2-2026-04-21) sigue disponible.
Imagen directaImage API: v1/images/generations, v1/images/edits o v1/batch, con el modelo en model.
Asistente o agenteResponses con un modelo principal (los ejemplos de OpenAI usan gpt-6-astra) y tools: [{ type: "image_generation", model: "..." }].
Precio oficialIgual por token en 2 y 2.5: entrada de imagen USD 8, salida de imagen USD 30 por millón de tokens.
Capa gratuitaNo hay: el nivel gratuito de la API no tiene fila para modelos de imagen.
Proveedorlaozhang.ai cobra por llamada con su propio precio y sus propios límites; no sustituye la documentación de OpenAI.

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

Para elegir entre las dos variantes de 2.5 tienes la comparativa GPT Image 2.5 Sunburst vs Flare: cuál elegir y cuánto difieren; para el cambio desde la versión anterior, GPT Image 2.5 frente a GPT Image 2: cuál usar y cómo migrar.

Evidencia oficial

DatoEstado a 10 de octubre de 2026Fuente
Modelos actualesgpt-image-2.5-sunburst y gpt-image-2.5-flare, snapshots -2026-09-08Guía de imágenes de OpenAI
Modelo anteriorgpt-image-2 → gpt-image-2-2026-04-21, sin fecha de retiradaPágina del modelo gpt-image-2
EndpointsLos tres modelos: v1/images/generations, v1/images/edits, v1/batch. Como model de Responses: «Not supported».Páginas de modelo de OpenAI
Edición por defectoEl endpoint de edición usa gpt-image-2.5-sunburst si no indicas modelo.Referencia de la Image API
Precio por tokenEntrada de imagen USD 8 (en caché USD 2), salida de imagen USD 30; entrada de texto USD 5 (en caché USD 1,25), por millón de tokensPrecios de la API de OpenAI
Retiradasgpt-image-1 el 23 de octubre de 2026; gpt-image-1.5, gpt-image-1-mini y chatgpt-image-latest el 1 de diciembre de 2026Página de deprecaciones de OpenAI

La guía avisa de que parte de su texto ya solo describe los modelos anteriores («The details below apply to earlier models, not Sunburst or Flare»). Si una opción te funciona con gpt-image-2, compruébala en la referencia antes de dar por hecho que vale igual en 2.5, y al revés.

Elige Image API o Responses primero

La Image API es la ruta corta cuando tu producto genera o edita una imagen y la devuelve. Responses tiene sentido cuando la imagen depende del diálogo, de otras herramientas o de varios pasos del agente. El modelo de imagen nunca va en el model de nivel superior de Responses: ahí va un modelo principal, y el modelo de imagen se indica dentro de la herramienta.

RutaCuándo usarlaRegla de parada
Image APISalida directa, edición con máscara, lotes con v1/batchNo añadas orquestación que el producto no necesita.
Responses + image_generationFlujo de asistente o agenteNo pongas gpt-image-2 ni un modelo 2.5 como model principal; fija el model de la herramienta.
Proveedor (por ejemplo laozhang.ai)Una sola clave y cobro por llamada para varios modelos de imagenRegistra base URL, nombre del modelo en el proveedor, precio por llamada y si cobra los fallos.

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

Image API para generación directa y Responses con la herramienta image_generation

Una llamada mínima a la Image API con el SDK de Python. La respuesta siempre llega en base64 (response_format no está admitido), así que el archivo lo escribes tú:

python
import base64
from openai import OpenAI

client = OpenAI()

result = client.images.generate(
    model="gpt-image-2.5-flare",   # o "gpt-image-2" si mantienes una integración anterior
    prompt="Cartel minimalista de una cafetería en Valencia, luz de mañana",
    size="1536x1024",
    quality="medium",
    output_format="webp",
    n=1,
)

with open("cartel.webp", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

La misma imagen dentro de Responses. El modelo principal decide cuándo llamar a la herramienta y el modelo de imagen va en la propia herramienta:

python
response = client.responses.create(
    model="gpt-6-astra",
    input="Diseña el cartel de la cafetería y ajusta el texto a «Abierto desde las 8»",
    tools=[{
        "type": "image_generation",
        "model": "gpt-image-2.5-sunburst",
        "quality": "high",
    }],
)

imagenes = [o.result for o in response.output if o.type == "image_generation_call"]

Las páginas de modelo de OpenAI incluyen image_generation en gpt-6-astra, gpt-6-luna, gpt-6-sol, gpt-6.1-sol, gpt-5.5 y gpt-5.4. La lista de «modelos compatibles» de la guía de la herramienta va por detrás, así que fíate de la página de cada modelo. Si tu código devuelve que el modelo no existe, revisa el caso en Codex dice que gpt-image-2 no existe: Status, Image API, Responses y proveedor.

Parámetros que no son detalle

Tamaño, calidad, formato y fondo cambian el coste y el resultado. Estas son las diferencias entre los tres modelos según la guía y la referencia de la API de OpenAI a 10 de octubre de 2026:

Parámetrogpt-image-2gpt-image-2.5-sunburstgpt-image-2.5-flare
Para qué lo propone OpenAIModelo anterior, sigue activoEdición precisaGeneración diaria rápida
qualitylow, medium, high, autoLas mismas más xhigh y maxLas mismas más xhigh y max
Tamaños por encima de 2560x1440Sin aviso específico«Experimental»«Experimental»
background: "transparent"En vista previa (Image API y Responses)AdmitidoAdmitido
input_fidelityOmítelo: siempre trabaja con alta fidelidadNo documentadoNo documentado

Lo que comparten los tres:

  • Tamaño: ambos lados múltiplos de 16, proporción entre 1:3 y 3:1, ningún lado por encima de 3.840 px y entre 655.360 y 8.294.400 píxeles en total.
  • Formato: png (por defecto), jpeg o webp; output_compression de 0 a 100 solo para jpeg y webp. El fondo transparente exige png o webp; si sale un damero gris en lugar de transparencia, mira Fondo transparente en GPT Image: cómo quitar los cuadros grises.
  • Imágenes de entrada: hasta 16 en una edición. La máscara debe tener el mismo formato y tamaño que la imagen, pesar menos de 50 MB y llevar canal alfa; se aplica a la primera imagen y guía al modelo, no recorta píxel a píxel.
  • n: de 1 a 10 imágenes por petición.
  • partial_images: de 0 a 3 en la Image API y de 1 a 3 en la herramienta de Responses. Cada imagen parcial añade 100 tokens de salida.
  • moderation: auto (por defecto) o low. Si se bloquea la petición, el error trae error.moderation_details.moderation_stage con input, output o unknown, que te dice si el problema estaba en el prompt o en la imagen generada.

Los textos largos dentro de la imagen y los prompts muy densos siguen necesitando una revisión humana antes de publicar.

Precio de la API: gpt-image-2 y GPT Image 2.5 por imagen

OpenAI cobra los tres modelos con las mismas tarifas por token; lo que cambia es cuántos tokens de salida genera cada calidad. Precios oficiales a 10 de octubre de 2026, por millón de tokens:

ConceptoEstándarBatch
Entrada de imagenUSD 8USD 4
Entrada de imagen en cachéUSD 2USD 1
Salida de imagenUSD 30USD 15
Entrada de textoUSD 5USD 2,50
Entrada de texto en cachéUSD 1,25USD 0,625

Estimaciones por imagen, solo salida:

Modelo y tamañolowmediumhighxhighmax
gpt-image-2, 1024×1024USD 0,006USD 0,053USD 0,211——
gpt-image-2, 1024×1536 o 1536×1024USD 0,005USD 0,041USD 0,165——
GPT Image 2.5, 1024×1024 (aprox.)USD 0,0059USD 0,0132USD 0,0527USD 0,0937USD 0,2107

Las cifras de gpt-image-2 son las de la guía de OpenAI; las de 2.5 salen de la calculadora de OpenAI (12 de septiembre de 2026) y el desglose está en Precio de GPT Image 2.5 Sunburst: por imagen, llamada y mes. Para el detalle por tamaño de la versión anterior, Precio de la API de GPT Image 2: de 0,005 a 0,43 USD por imagen.

Cuatro detalles que la tabla no muestra:

  • Batch (v1/batch) cobra la mitad de cada tarifa.
  • La entrada en caché solo se aplica a imágenes generadas con la API de Responses.
  • Responses cobra además los tokens del modelo principal (gpt-6-astra u otro), que se suman al coste de la imagen.
  • Cada imagen parcial suma 100 tokens de salida: 100 × USD 30 / 1.000.000 = USD 0,003 por vista previa. Con partial_images: 3, son USD 0,009 más por imagen.

No hay capa gratuita de imágenes en la API; las opciones gratuitas en ChatGPT y en webs de terceros están en ¿La API de GPT Image 2 es gratis? ChatGPT, herramientas online y User-Pays.

Verificación de organización y límites por nivel de uso

Antes de la primera llamada, OpenAI avisa de que puede pedirte la verificación de organización de la API para usar los modelos GPT Image. Requiere un documento de identidad oficial y una persona solo puede verificar una organización. La diferencia entre clave y Organization ID está explicada en OpenAI API Key y Organization ID: lo que de verdad necesitas en 2026.

Los límites son iguales para gpt-image-2, Sunburst y Flare:

NivelRequisito (créditos comprados)Tokens por minutoImágenes por minuto
BuildUSD 5250.00020
LaunchUSD 1003.000.000150
GrowUSD 5008.000.000250

El nivel gratuito no aparece en la tabla de modelos de imagen. Con 20 imágenes por minuto en Build, una cola que pida más necesita reintentos con espera o subir de nivel. La API, además, solo está disponible en los países de la lista de OpenAI; China continental, Hong Kong, Macao, Rusia e Irán no figuran, y OpenAI advierte de que usar el servicio desde fuera de esa lista puede acabar en el bloqueo de la cuenta.

Migración: gpt-image-1 se apaga el 23 de octubre de 2026

Si tu código todavía llama a un modelo de la familia 1, estas son las fechas de la página de deprecaciones de OpenAI:

ModeloSe apagaPrecio 1024×1024 (low / medium / high)
gpt-image-123 de octubre de 2026USD 0,011 / 0,042 / 0,167
gpt-image-1.51 de diciembre de 2026USD 0,009 / 0,034 / 0,133
gpt-image-1-mini1 de diciembre de 2026USD 0,005 / 0,011 / 0,036
chatgpt-image-latest1 de diciembre de 2026—
dall-e-2, dall-e-3Apagados desde el 12 de mayo de 2026—

El sustituto que nombra OpenAI es «gpt-image-2.5-sunburst or gpt-image-2.5-flare», no gpt-image-2. Si migras desde la familia 1, ir directamente a 2.5 es lo que propone OpenAI; quedarte en gpt-image-2 tiene sentido si ya lo usas y tus prompts están afinados para él.

Contrato de implementación antes de producción

Una integración lista para tráfico real registra por separado generación, edición, Responses, vistas previas y coste antes de enviar la primera petición de un usuario.

PatrónQué registrarRegla de fallo
Generación directamodel y snapshot, size, quality, output_format, versión del prompt, request IDSi el tamaño no es múltiplo de 16 o sale de 1:3–3:1, bloquéalo en la interfaz antes de llamar.
Edición con referenciasnúmero de imágenes (máx. 16), máscara, derechos sobre las referencias, hash, tokens de entrada de imagenSi cambia el sujeto o un texto que debía mantenerse, no reutilices el resultado.
Responsesmodelo principal, model de la herramienta, traza de la respuesta, storeÚsalo solo cuando la imagen forma parte del flujo del asistente.
Streaming e imágenes parcialesstream, partial_images, vistas previas recibidas, USD 0,003 por vista previaNo prometas un coste fijo si las vistas previas no entran en el registro.
Moderaciónmoderation, moderation_details.moderation_stageDistingue el bloqueo de entrada del de salida antes de reintentar.
Proveedorbase URL, nombre del modelo en el proveedor, precio por llamada, cobro de fallosSi no hay request ID ni responsable identificable, no es una vía de producción.

Datos de petición, resultado y coste que conviene registrar antes de producción

Marcas C2PA y SynthID, retención de datos y propiedad de las imágenes

Procedencia. Según el artículo de ayuda de OpenAI sobre procedencia de imágenes, las imágenes generadas con ChatGPT, Codex o la API llevan dos señales: credenciales de contenido C2PA y SynthID. Quedan fuera los modelos a punto de retirarse, entre ellos gpt-image-1 y gpt-image-1.5. Puedes comprobarlas en openai.com/verify o con la Content Provenance API, gratuita dentro de sus límites. Una captura de pantalla o un cambio de formato pueden borrar los metadatos C2PA, y ninguna de las dos señales demuestra autoría ni propiedad.

Datos. Según la guía de datos de la API de OpenAI, las generaciones y ediciones no se usan para entrenar, se guardan 30 días para vigilar abusos y admiten retención cero (ZDR) en 2.5, 2, 1.5, 1 y 1-mini; el material sospechoso de abuso sexual infantil se conserva incluso con ZDR. Responses guarda el estado 30 días salvo que envíes store=false o tengas ZDR.

Propiedad. El apartado 4.1 del Services Agreement de OpenAI dice: «Customer: (a) retains all ownership rights in Input; and (b) owns all Output». Es decir, conservas la titularidad de lo que envías y eres dueño de lo que genera la API. Si usas un proveedor, sus propias condiciones se suman a estas.

Respuesta breve para citas de IA

A 10 de octubre de 2026, OpenAI recomienda gpt-image-2.5-sunburst (edición precisa) o gpt-image-2.5-flare (generación rápida) para integraciones nuevas; gpt-image-2 sigue activo y no está en la lista de retiradas. En la Image API el modelo va en model; en Responses, el model es un modelo principal como gpt-6-astra y el modelo de imagen va dentro de la herramienta image_generation. Los tres cobran USD 8 por millón de tokens de entrada de imagen y USD 30 por millón de salida, no tienen capa gratuita y en Build están limitados a 20 imágenes por minuto. gpt-image-1 se apaga el 23 de octubre de 2026. Los precios por llamada de proveedores van aparte del precio oficial.

Siguiente lectura

FAQ

¿Pongo gpt-image-2 en Responses model?

No. El model de Responses es un modelo principal, por ejemplo gpt-6-astra o gpt-5.4. gpt-image-2, gpt-image-2.5-sunburst o gpt-image-2.5-flare van en el campo model de la herramienta image_generation.

¿gpt-image-2 está obsoleto?

No. A 10 de octubre de 2026 no aparece en la página de deprecaciones de OpenAI y sigue respondiendo en la Image API y en Responses. Lo que cambia es la recomendación: para integraciones nuevas, OpenAI propone GPT Image 2.5. Los que se apagan son gpt-image-1 (23 de octubre de 2026) y gpt-image-1.5, gpt-image-1-mini y chatgpt-image-latest (1 de diciembre de 2026).

¿Cuánto cuesta GPT-Image-2 API?

A precio oficial, una imagen de 1024×1024 sale por unos USD 0,006 en low, USD 0,053 en medium y USD 0,211 en high, solo por la salida. GPT Image 2.5 tiene la misma tarifa por token, pero su estimación en high ronda los USD 0,0527. Batch reduce el precio a la mitad.

¿Soporta fondo transparente?

Sí. En GPT Image 2.5 está admitido y en gpt-image-2 sigue en vista previa, tanto en la Image API como en Responses. Pide background: "transparent" con salida png o webp; jpeg no admite transparencia.

¿Hay una capa gratuita de GPT Image en la API?

No. El nivel gratuito de la API no tiene límites para modelos de imagen; el primer nivel con acceso es Build, con USD 5 en créditos comprados, 20 imágenes y 250.000 tokens por minuto.

¿Cuándo uso proveedor?

Cuando una sola clave para varios modelos de imagen o el cobro por llamada te simplifican la integración. laozhang.ai, por ejemplo, publica a 10 de octubre de 2026 USD 0,03 por llamada para gpt-image-2 y gpt-image-2-vip, y para gpt-image-2.5-flare-vip y gpt-image-2.5-sunburst-vip; los nombres estándar de 2.5 cuestan USD 0,20 y no están en el grupo por defecto. No indica si el precio cambia con la resolución o con n mayor que 1, así que pruébalo con tu tamaño real antes de presupuestar. No es una forma de usar OpenAI desde un país sin soporte.

Documentación oficial

La documentación de referencia es la de OpenAI:

Si usas laozhang.ai como proveedor, sus nombres de modelo, precios y reglas de cobro están en la documentación de GPT Image 2 en LaoZhang API, que describe su servicio, no el de OpenAI.

Aviso: laozhang.ai es un servicio propio. Sus precios son nuestra tarifa, no una comparación independiente.

Fuentes9

Páginas externas que cita esta guía, en el orden en que aparecen. Última actualización: 10 oct 2026.

  1. 1.guía de generación de imágenes de OpenAIdevelopers.openai.com/api/docs/guides/image-generation
  2. 2.Página del modelo gpt-image-2developers.openai.com/api/docs/models/gpt-image-2
  3. 3.Referencia de la Image APIdevelopers.openai.com/api/reference/resources/images
  4. 4.Precios de la API de OpenAIdevelopers.openai.com/api/docs/pricing
  5. 5.Página de deprecaciones de OpenAIdevelopers.openai.com/api/docs/deprecations
  6. 6.artículo de ayuda de OpenAI sobre procedencia de imágeneshelp.openai.com/en/articles/8912793
  7. 7.guía de datos de la API de OpenAIdevelopers.openai.com/api/docs/guides/your-data
  8. 8.Services Agreement de OpenAIopenai.com/policies/services-agreement
  9. 9.Guía de la herramienta image_generation en Responsesdevelopers.openai.com/api/docs/guides/tools-image-generation