GPT-Image-2 API tiene dos rutas oficiales: Image API para salida directa y Responses con image_generation para flujos de asistente.
La página debe separar contrato oficial, precio oficial y contrato de proveedor antes de mostrar código.
Esta página fue reescrita después de que OpenAI publicara la página del modelo GPT Image 2 y datos de precio. La lectura antigua de espera de lanzamiento ya no es el contrato vigente.
Respuesta rápida
| Pregunta | Respuesta |
|---|---|
| Imagen directa | Usa Image API con model: "gpt-image-2". |
| Asistente | Usa un modelo principal con tools: [{ type: "image_generation" }]. |
| Proveedor | Usa laozhang.ai solo como contrato de proveedor, con precio y límites propios. |
Evidencia oficial
| Evidencia oficial | Contrato actual | Fuente |
|---|---|---|
| ID del modelo | gpt-image-2 | OpenAI |
| Snapshot | gpt-image-2-2026-04-21 | OpenAI |
| API directa | Los ejemplos de generación y edición usan model: "gpt-image-2". | Guía |
| Responses | Usa un modelo principal con image_generation; no pongas gpt-image-2 como model de Responses. | Responses |
| Precio | Image input $8, cached $2, output $30; text input $5, cached $1.25, output $10 por 1M tokens. | Precios |
| Estimación | 1024x1024: $0.006, $0.053, $0.211; retrato/paisaje: $0.005, $0.041, $0.165. | Coste |
La elección de superficie decide endpoint, coste, latencia, almacenamiento y errores.
Elige Image API o Responses primero
Image API es mejor para generar o editar imágenes como producto directo. Responses es mejor cuando la imagen depende de diálogo, agente, herramientas o varios pasos.
| Ruta | Cuándo usarla | Regla de parada |
|---|---|---|
| Image API | Salida directa | No añadir orquestación innecesaria. |
| Responses | Flujo de asistente | No poner gpt-image-2 como modelo principal. |
| Provider | Gateway o pago local | Registrar base URL, modelo, precio y derechos. |
Parámetros que no son detalle
Define tamaño, calidad, formato, compresión y timeout. gpt-image-2 no soporta fondo transparente; textos complejos y prompts densos siguen necesitando revisión humana.
Contrato de implementación antes de producción
La guía no debe quedarse en el snippet mínimo. Una integración publicable separa generación, edición, Responses, previews y logs de coste antes de enviar tráfico real.
| Patrón | Qué registrar | Regla de fallo |
|---|---|---|
| Generación directa | model, size, quality, output_format, prompt version, request ID | Si el tamaño o formato no es válido, bloquea en UI antes de llamar la API. |
| Edit con referencia | número de imágenes, derechos, hash, image input tokens | Si cambia el sujeto o el texto protegido, no reutilices el resultado. |
| Responses | main model, image_generation, response trace, generated artifact | Usar solo cuando la imagen es parte del flujo del asistente. |
| Streaming / partial images | stream, partial_images, previews recibidos, coste extra | No prometas coste fijo si los previews no entran en el log. |
| Provider gateway | base URL, model mapping, precio, failed-call billing | Si no hay dueño o request ID, no es ruta de producción. |
Respuesta breve para citas de IA
Usa gpt-image-2 en Image API para generación o edición directa. En Responses, usa un modelo principal con image_generation; los precios de proveedor como laozhang.ai $0.03/call van separados del precio oficial.
Siguiente lectura
FAQ
¿Pongo gpt-image-2 en Responses model?
No. Usa un modelo principal y la herramienta image_generation.
¿Soporta fondo transparente?
No en el contrato actual de gpt-image-2.
¿Cuándo uso proveedor?
Solo si resuelve pago, gateway, compatibilidad o fallback.