OpenAI
GPT Image 2
gpt-image-2/image-to-image
Modelo de generación y edición de imágenes de OpenAI, especializado en realismo fotográfico, renderizado de texto de alta precisión y salida 4K nativa, ideal para materiales comerciales y fotos de producto que incluyen texto
Probar gpt-image-2/image-to-image
Entrada
Creaciones
Ver todas las creacionesSalida
imagePrecios
gpt-image-2/image-to-image per image
| Especificaciones | Precio unitario |
|---|---|
| 1K | $0.030 |
| 2K | $0.040 |
| 4K | $0.060 |
gpt-image-2/image-to-image @ext per image
Descripción general
gpt-image-2/image-to-image es la línea de la serie de modelos de imagen de OpenAI orientada a la regeneración y edición de imágenes: recibe de 1 a 16 imágenes de referencia y un mensaje de texto, y genera una imagen reconstruida. Resulta adecuada para escenarios de desarrollo en los que se necesita reescribir, ampliar, unificar el estilo o sustituir el formato a partir de material existente, y permite elegir la relación de aspecto según las especificaciones de publicación, con una resolución máxima de 4K. En comparación con la generación puramente a partir de texto, el valor de esta línea radica en que el resultado generado se ancla en las imágenes de referencia proporcionadas por el desarrollador.
Puntos clave
- Entrada con múltiples imágenes de referencia: en una sola llamada se pueden enviar de 1 a 16 imágenes de referencia, de modo que el conjunto de material sirve de base para la generación, en lugar de depender solo de una descripción textual.
- Relación de aspecto según especificaciones de publicación: incluye más de diez proporciones integradas, desde 1:1 y 16:9 hasta 21:9 y 9:21, lo que permite alinearlas directamente con páginas de destino, feeds y material vertical.
- Resolución de hasta 4K: admite tres niveles de salida (1K, 2K y 4K); la relación de aspecto 1:1 no admite 4K; la alta resolución es apta para material de nivel de impresión o para pantallas grandes.
- Salida con fondo transparente: con resolución 1K se puede elegir entre fondo transparente, opaco o automático, lo que facilita la superposición directa en otras capas de diseño.
Descripción de capacidades
Reescritura de imágenes guiada por referencias: genera una nueva imagen a partir de la imagen de entrada; es adecuada para cambiar el estilo, ajustar la composición o crear variantes sobre material existente, y el resultado hereda las claves visuales de la imagen de referencia.
Control combinado de relación de aspecto y resolución: las especificaciones de salida se determinan mediante los parámetros aspect_ratio y resolution; al elegir auto o relaciones de aspecto especiales, el formato queda limitado a 1K, por lo que conviene establecer estas restricciones de antemano en los parámetros.
Control del modo de fondo: el parámetro background ofrece tres valores (auto, opaque y transparent), que solo surten efecto con resolución 1K y resultan adecuados para flujos posteriores que requieren eliminación del fondo o composición por capas.
Restricción de mensajes largos: el límite de prompt es de 20000 caracteres, lo que permite incluir de una vez múltiples restricciones, indicaciones de formato y contenido de copy, reduciendo las descripciones complementarias en varias rondas.
Fusión de material de varias imágenes: input_urls permite enviar varias imágenes a la vez, de modo que se pueden proporcionar por separado el sujeto, las referencias de estilo y las muestras de formato para que el modelo los integre en una sola salida.
Casos de uso
- Equipos de diseño que amplían un key visual existente a múltiples formatos: se sube el key visual junto con los requisitos de distintas relaciones de aspecto y se producen en lote versiones adaptadas a feeds, pantallas de apertura y formato vertical, listas para incorporarse directamente al repositorio de material publicitario.
- Operaciones de comercio electrónico que regeneran imágenes de producto en distintos entornos: se envían fotos reales del producto y se generan imágenes finales con distintos fondos e iluminaciones para sustituirlas en páginas de detalle y espacios publicitarios.
- Iteración de maquetación de texto e imagen en diseño visual: tomando como referencia una maqueta existente, se sustituyen los textos y elementos gráficos mediante prompts para producir una nueva versión del diseño que sirva de base para la revisión.
- Flujos de composición que necesitan material con fondo transparente: se activa la salida con fondo transparente en 1K para superponer el resultado directamente en otras capas o escenarios, ahorrándose el recorte manual.
Limitaciones y recomendaciones de selección
Esta línea solo genera imágenes y no abarca otras modalidades como vídeo o texto. Existen restricciones combinadas entre resolución y relación de aspecto: las relaciones automáticas o especiales solo admiten 1K, la relación 1:1 no admite 4K y el fondo transparente solo está disponible en 1K, por lo que hay que sopesar entre alta especificación y control del fondo al configurar los parámetros. La alta resolución y las múltiples referencias aumentan el tiempo de generación y el coste de las llamadas, por lo que no es adecuada para escenarios de interacción en tiempo real con requisitos de latencia muy bajos; si solo se necesita generar imágenes directamente a partir de texto, sin material de referencia, conviene elegir la línea de generación a partir de texto de la misma familia.
Novedades
Ver el registro de cambios →- Cambio de parámetro gpt-image-2 añade niveles de resolución 1K / 2K / 4K
Preguntas frecuentes
Ver todas las preguntas →-
¿Qué es GPT Image 2?
GPT Image 2 es el modelo de texto a imagen de OpenAI, adecuado para carteles, tarjetas de conocimiento, visuales de producto y la generación de imágenes con requisitos claros de texto y composición.
-
¿GPT Image 2 y GPT Image 2.0 son el mismo modelo?
GPT Image 2.0 es una abreviatura de búsqueda común; utilice el ID de modelo exacto que figura en la página de GPT Image 2 y en la documentación de la API.
-
¿Qué endpoint y qué ID de modelo utiliza la API de GPT Image 2?
Envía una solicitud a POST /v1/tasks, establece model en gpt-image-2/text-to-image para texto a imagen y pasa prompt, aspect_ratio y resolution en input. La interfaz primero devuelve un taskId y luego se obtiene la imagen final mediante consulta de tarea o callback.
-
¿Cómo usar GPT Image 2?
En el Playground, especifica el sujeto, la escena, el diseño y el texto que debe aparecer; luego selecciona el formato, la resolución y el fondo, haz clic en ejecutar y revisa el resultado.
Crear una tarea de generación
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.
Idempotency-KeystringOpcionalClave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.
Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.
Cuerpo
modelstringObligatorioValor fijo actual: gpt-image-2/image-to-image
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para gpt-image-2/image-to-image y la ruta default; consulta la tabla de parámetros a continuación.
promptstringObligatoriominLength 1maxLength 20000Indicación de texto, obligatoria, longitud máxima de 20000 caracteres, se utiliza para describir el contenido de la imagen que se desea generar.
backgroundstringOpcionalModo de fondo, controla la forma de procesar el fondo de la imagen generada; este parámetro solo es compatible con resolución 1K.
autoopaquetransparentinput_urlsarrayObligatoriominItems 1maxItems 16Arreglo de URL de imágenes de referencia, proporciona una o varias imágenes como referencia para la generación de imagen a imagen; admite de 1 a 16 imágenes.
Array [ string ]
resolutionstringOpcionalPredeterminado: "1K"Resolución de la imagen generada, por defecto 1K. Cuando aspect_ratio es auto se debe usar 1K; 1:1 no admite 4K; cuando aspect_ratio es 3:1/1:3/9:21 solo se admite 1K; cuando background es auto/opaque/transparent solo se admite 1K.
1K2K4Kaspect_ratiostringOpcionalPredeterminado: "auto"Relación de aspecto de la imagen generada, por defecto auto. Cuando el valor es auto o se omite, solo se admite la resolución 1K.
auto1:13:22:34:33:45:44:5Mostrar todo (8)
16:99:162:11:23:11:321:99:21callbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.
urlstringObligatorioObligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.
whenstringOpcionalPredeterminado: "final"Actualmente solo se admite final: notifica tanto en success como en fail.
finalstoragestringOpcionalPredeterminado: "temp"Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.
temppersistentmodelstringObligatorioValor fijo actual: gpt-image-2/image-to-image
routestringOpcionalValor fijo actual: ext
inputobjectObligatorio
Objeto de parámetros de negocio para gpt-image-2/image-to-image y la ruta ext; consulta la tabla de parámetros a continuación.
promptstringObligatoriominLength 1maxLength 20000图像编辑提示词 Max 20000 characters.
qualitystringObligatorioPredeterminado: "low"lowmediumhighimage_urlsarrayObligatoriominItems 1maxItems 6参考图 URL 或 data URI,最多 6 张
Array [ string ]
resolutionstringObligatorioPredeterminado: "1K"1K2K4Kaspect_ratiostringOpcionalPredeterminado: "auto"输出画幅比例
auto1:13:22:34:33:45:44:5Mostrar todo (8)
16:99:162:11:23:11:321:99:21callbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.
urlstringObligatorioObligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.
whenstringOpcionalPredeterminado: "final"Actualmente solo se admite final: notifica tanto en success como en fail.
finalstoragestringOpcionalPredeterminado: "temp"Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.
temppersistentEjemplos de solicitud
# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2/image-to-image",
"input": {
"prompt": "…",
"input_urls": "…",
"resolution": "1K",
"aspect_ratio": "auto"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "gpt-image-2/image-to-image",
input: {
"prompt": "…",
"input_urls": "…",
"resolution": "1K",
"aspect_ratio": "auto"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "gpt-image-2/image-to-image",
"input": {
"prompt": "…",
"input_urls": "…",
"resolution": "1K",
"aspect_ratio": "auto"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} # Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2/image-to-image@ext",
"input": {
"prompt": "…",
"quality": "low",
"image_urls": "…",
"resolution": "1K",
"aspect_ratio": "auto"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "gpt-image-2/image-to-image@ext",
input: {
"prompt": "…",
"quality": "low",
"image_urls": "…",
"resolution": "1K",
"aspect_ratio": "auto"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "gpt-image-2/image-to-image@ext",
"input": {
"prompt": "…",
"quality": "low",
"image_urls": "…",
"resolution": "1K",
"aspect_ratio": "auto"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtener el detalle de la tarea
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
queued En cola, sin iniciar.
handling Procesando.
archiving Proceso terminado, preparando artefactos.
success Terminal: completado, artefactos disponibles (se devuelve output).
fail Terminal: error (se devuelve error).
Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.
outputarrayOpcional
Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).
Array [ object ]
Elementos del array
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripción del error.
Ejemplos de respuesta
Éxito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En proceso (no terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fallido
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artículos
Ver todos los artículos →-
Tutorial
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
-
Tutorial
Cómo llamar a hailuo-2.3-fast/image-to-video a través de la API de HiAPI: práctica con curl y Python
La primera solicitud ejecutable del nivel rápido y de bajo coste de imagen a vídeo: del ID del modelo a la descarga del MP4
-
Comparativa
Recraft v4.1 Flash comparativa horizontal de texto a imagen: guía de selección y migración para desarrolladores
Con un coste de $0.01 por imagen y capacidad pura de texto a imagen, evalúa si encaja en tu pipeline de generación de imágenes
-
Tutorial
Cómo usar kling-4.0/text-to-video a través de la API de HiAPI: curl, Python y un ejemplo de solicitud ejecutable
Guía práctica para desarrolladores: prompts cinematográficos, audio sincronizado, sondeo asíncrono y descarga de resultados
-
Tutorial
Uso de Kandinsky 6.0 Pro texto a video en HiAPI: tutorial con curl y Python
Demostración práctica centrada en la solicitud: construir la llamada de prompt a clip de video, enviar la solicitud, sondear el estado de finalización y descargar el resultado
-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video en HiAPI: curl + Python
Realiza una solicitud de imagen a video funcional en HiAPI: desde la carga del primer fotograma hasta el sondeo asíncrono y la descarga final
-
Comparativa
hailuo-2.3-fast/image-to-video comparativa horizontal: cómo elegir un modelo de imagen a video y puntos clave para migrar
-
Tutorial
Cómo llamar a kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
FLUX.1 Kontext Max Black Forest Labs $0.071 /imagen -
Recraft V4.1 Recraft $0.010 /imagen -
Grok Imagine xAI $0.011 /segundo -
Imagen 4 Google $0.030 /imagen -
Qwen Image 3.0 Alibaba $0.036 /imagen -
FLUX 1.1 Pro Black Forest Labs $0.050 /imagen -
Krea 2 Medium Turbo Krea $0.021 /imagen -
851 Labs Background Remover 851 Labs $0.002 /imagen -
Nano Banana Google $0.021 /imagen -
Wan 2.7 Image Alibaba $0.035 /imagen -
Qwen Image 2.0 Alibaba $0.042 /imagen -
Ideogram V4.5 Ideogram $0.011 /imagen









