Guía de la API de GPT Image: ID de modelo, rutas y migración

Respuesta breve

Para nuevas integraciones de imagen directas con OpenAI, el ID de modelo actual es gpt-image-2. Para nuevas integraciones con HiAPI, si la tarea comienza con un prompt, use gpt-image-2/text-to-image; si la tarea comienza con una o varias imágenes de referencia, use gpt-image-2/image-to-image.

Estos nombres se confunden fácilmente porque la gente usa "GPT-4o image", "ChatGPT image generation", "GPT Image API" y "GPT Image 2" para referirse a interfaces de producto relacionadas pero distintas. Lo prudente es confirmar primero qué API va a invocar y después usar el ID de modelo y el contrato de solicitud correspondientes a esa API.

Interfaz	Modelo o selector actual	Modo de solicitud
OpenAI Image API	gpt-image-2	OpenAI /v1/images/generations o /v1/images/edits
OpenAI Responses API	Modelos principales compatibles más la herramienta de generación de imágenes	Trabajo de imagen conversacional o de varios pasos mediante /v1/responses
HiAPI texto a imagen	gpt-image-2/text-to-image	POST https://api.hiapi.ai/v1/tasks
HiAPI imagen a imagen	gpt-image-2/image-to-image	POST https://api.hiapi.ai/v1/tasks

HiAPI no actúa como proxy del cuerpo de solicitud de OpenAI Image API. Ofrece las rutas de GPT Image mediante un contrato de tareas asíncronas unificado, por lo que cambiar solo el nombre del host no equivale a completar la migración.

El linaje de GPT Image que los desarrolladores deben conocer

El linaje útil es un mapa de migración accionable. No todos los nombres siguientes apuntan a modelos de API intercambiables.

Nombre que podría ver en código antiguo o en resultados de búsqueda	Estado actual	Qué hacer ahora
"GPT-4o image generation" o "ChatGPT image generation"	Expresión de interfaz de producto o de UI, no un ID de modelo de imagen actual que pueda pegarse en una nueva solicitud de imagen	Elija primero una interfaz de API y después use su modelo actual y su contrato de solicitud
chatgpt-4o-latest	Alias de modelo de ChatGPT obsoleto; la página de modelos actual de OpenAI indica entrada de imágenes, no salida de imágenes	No lo use como destino de migración para la generación de imágenes
gpt-image-1	OpenAI lo marca como modelo de generación de imágenes de generación anterior y obsoleto	Migre el nuevo trabajo de imagen a gpt-image-2
gpt-image-1.5	OpenAI lo marca como modelo de generación de imágenes de generación anterior y obsoleto	Migre el nuevo trabajo de imagen a gpt-image-2
dall-e-2 o dall-e-3	Obsoletos y eliminados de la API de OpenAI	OpenAI recomienda gpt-image-2 para la generación y edición actuales
gpt-image-2	ID del modelo de imagen directo actual de OpenAI	Úselo con OpenAI Image API o asigne la tarea a los ID con barra de HiAPI que se indican abajo

La documentación actual de OpenAI describe gpt-image-2 como su modelo de generación de imágenes más avanzado y documenta la generación de texto a imagen y la edición de imágenes. La guía de generación de imágenes de OpenAI también distingue la Image API de un solo uso de la generación de imágenes conversacional mediante la Responses API. Las notas sobre el estado de los modelos anteriores provienen de las siguientes páginas oficiales: GPT Image 2, GPT Image 1.5, GPT Image 1, DALL-E 2, DALL-E 3 y ChatGPT-4o, verificadas el 31 de agosto de 2026.

Pasar de un flujo de trabajo en la UI a un flujo de trabajo con API

Una sesión de imágenes de ChatGPT oculta la selección de modelo, el estado, los reintentos y el manejo de archivos detrás de la conversación. Una integración con API debe tomar esas decisiones de forma explícita.

La guía oficial de OpenAI recomienda usar su Image API para una generación o edición única y la Responses API para trabajo de imagen conversacional de varios turnos. HiAPI usa un tercer contrato: cada tarea de imagen es una tarea asíncrona. Su backend envía la tarea, almacena el taskId devuelto y recibe el resultado final mediante un callback o una solicitud posterior de detalles de la tarea.

El brief creativo de una sesión de UI sigue siendo un prompt inicial útil, pero debe trasladarse al esquema de solicitud real de la API y probar la salida. No copie el nombre del producto de la UI en el campo model suponiendo que es un ID de API estable.

Para HiAPI, mantenga la clave de API en el servidor y envíe la tarea así:

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2/text-to-image",
    "input": {
      "prompt": "A clean launch poster with the exact headline SUMMER DROP",
      "aspect_ratio": "4:5",
      "resolution": "1K"
    },
    "callback": {
      "url": "https://your-domain.com/hiapi/callback",
      "when": "final"
    }
  }'

El objeto callback debe estar en el nivel superior, junto a model e input. Para depuración local o conciliación, consulte mediante GET https://api.hiapi.ai/v1/tasks/{taskId}. Cuando la tarea se complete correctamente, descargue la imagen desde data.output[].url, en lugar de tratar la URL de salida temporal como almacenamiento permanente.

Esta página central muestra deliberadamente solo una solicitud. Para los campos específicos de cada ruta, los callbacks, el sondeo y ejemplos listos para copiar y pegar, consulte la documentación de la API de texto a imagen o la documentación de la API de imagen a imagen.

Migrar llamadas antiguas de imagen de OpenAI a HiAPI

La migración del modelo de OpenAI y la migración del contrato del proveedor son dos cambios independientes. Primero elija la tarea de imagen actual y después reescriba la solicitud para la API de tareas de HiAPI.

Entrada antigua	Destino directo actual en OpenAI	Destino actual en HiAPI
Texto a imagen con gpt-image-1, gpt-image-1.5 o un ID de DALL-E	Generación con gpt-image-2	gpt-image-2/text-to-image
Edición de imágenes con gpt-image-1 o gpt-image-1.5	Edición con gpt-image-2	gpt-image-2/image-to-image
Flujo de trabajo de imágenes solo en la UI de ChatGPT o GPT-4o	Elija OpenAI Image API o Responses API según el diseño de la interacción	Elija la ruta de tarea de texto a imagen o de imagen a imagen de HiAPI

Al migrar a HiAPI, sustituya el manejo de respuestas síncronas o específicas de OpenAI por la persistencia de taskId, el tratamiento de estados terminales y la descarga de salidas. Vuelva a validar los prompts y las salidas, y no prometa resultados idénticos píxel a píxel entre interfaces.

Migrar nombres de modelo antiguos de HiAPI

HiAPI ahora usa ID con barra específicos de cada tarea y selectores de ruta en el nivel superior. El código nuevo debe usar la forma de solicitud canónica que se muestra abajo.

Nombre antiguo de HiAPI	Solicitud actual
gpt-image-2	model: "gpt-image-2/text-to-image"
gpt-image-2-image-to-image	model: "gpt-image-2/image-to-image"
gpt-image-2-beta	model: "gpt-image-2/text-to-image" más route: "beta"
gpt-image-2-ext	model: "gpt-image-2/text-to-image" más route: "ext"
gpt-image-2-i2i-ext	model: "gpt-image-2/image-to-image" más route: "ext"

Los datos públicos de precios pueden escribir las entradas con ruta como gpt-image-2/text-to-image@ext o gpt-image-2/image-to-image@ext. HiAPI también acepta la forma con la ruta calificada, pero la documentación del modelo usa el ID base con barra más el campo route en el nivel superior, porque así resulta más fácil ver el esquema de entrada específico de cada ruta.

Sustituir los ID Pro retirados de HiAPI

HiAPI retiró dos ID Pro antiguos el 2 de julio de 2026. Ya no aparecen en los datos públicos de precios actuales y no deben conservarse en los nuevos ejemplos.

ID retirado	Alternativa
gpt-image-2-pro	gpt-image-2/text-to-image
gpt-image-2-image-to-image-pro	gpt-image-2/image-to-image

Esta migración de modelo no garantiza que todos los parámetros del antiguo Pro produzcan exactamente el mismo efecto. Consulte el esquema de ruta actual en la documentación del modelo correspondiente y después ejecute una prueba con un prompt y una imagen de referencia representativos antes del cambio en producción.

Dónde consultar a continuación

Esta página sirve para nombres, linaje y migración. Elija el destino correspondiente según la pregunta que quiera responder:

Inicio e integración

• Página del modelo GPT Image 2 para conocer el modelo actual y el Playground.
• Página del modelo GPT Image 2 de imagen a imagen para la edición con imágenes de referencia en el Playground.
• Documentación de texto a imagen de GPT Image 2 para los campos de solicitud standard, beta y ext.
• Documentación de imagen a imagen de GPT Image 2 para los campos de edición standard y ext, incluidas las diferencias de nomenclatura de las imágenes de referencia.
• Precios de la API de GPT Image 2 para la tabla de rutas actual, los complementos por imágenes de referencia y el cálculo del presupuesto.
• Precios en tiempo real de HiAPI para el catálogo completo de modelos actuales.

Casos de uso y evidencia de pruebas

• Plantillas de prompts de GPT Image 2 con salidas reales.
• Prueba de esfuerzo de renderizado de texto de GPT Image 2.
• Flujo de trabajo de comercio electrónico con GPT Image 2.
• Guía de la API de imagen a imagen de GPT Image 2.

Comparativas y selección

• GPT Image 2 frente a Nano Banana 2.
• GPT Image 2 frente a FLUX 1.1 Pro.
• Evaluación honesta de GPT Image 2.

Preguntas frecuentes

¿Cuál es el ID de modelo actual de la API de GPT Image?

Para la Image API directa de OpenAI, es gpt-image-2. Para HiAPI, use gpt-image-2/text-to-image o gpt-image-2/image-to-image según si la tarea comienza con texto o con una imagen de referencia.

¿Puedo enviar el nombre de modelo simple gpt-image-2 a HiAPI?

No use el nombre simple en el nuevo código de HiAPI. Los ID canónicos actuales son los nombres con barra específicos de cada tarea que se muestran arriba, y además hacen más explícitos el enrutamiento de precios, los esquemas y las páginas de modelo.

¿HiAPI usa el endpoint /v1/images/generations de OpenAI?

No. Los modelos de imagen de HiAPI usan POST /v1/tasks y después obtienen el resultado mediante un callback final o GET /v1/tasks/{taskId}. Los contratos de solicitud y respuesta de OpenAI Image API y de la API de tareas de HiAPI son distintos.

¿Dónde debe colocarse el callback?

Coloque callback en el nivel superior del cuerpo de la tarea, junto a model e input. Use callback.when: "final" y haga que el servicio receptor sea idempotente según el taskId, ya que tanto el éxito como el fallo son resultados terminales.

¿Qué sustituye a gpt-image-2-pro?

Use gpt-image-2/text-to-image. Para el ID Pro de imagen a imagen retirado, use gpt-image-2/image-to-image. Antes de cambiar, consulte el esquema de entrada actual y pruebe una tarea representativa.