OpenAI
GPT Image 2
gpt-image-2/text-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/text-to-image
Entrada
Creaciones
Ver todas las creacionesSalida
imagePrecios
gpt-image-2/text-to-image per image
| Especificaciones | Precio unitario |
|---|---|
| 1K | $0.030 |
| 2K | $0.040 |
| 4K | $0.060 |
gpt-image-2/text-to-image @beta per image
| Especificaciones | Precio unitario |
|---|---|
| With Reference Resources | $0.020 |
gpt-image-2/text-to-image @ext per image
Descripción general
gpt-image-2 es un modelo de generación de imágenes a partir de texto de OpenAI, orientado a desarrolladores que necesitan producir de forma estable material visual de nivel comercial. Destaca por respetar las múltiples restricciones de prompts complejos, mantiene una buena limpieza de composición en carteles, envases y maquetas que contienen texto, y admite resoluciones de 1K a 4K y diversas relaciones de aspecto. Basta con enviar un prompt a través de la interfaz unificada de HiAPI.ai para obtener una imagen, lo que lo hace adecuado para equipos que desean integrar la generación de imágenes en herramientas de diseño, flujos de trabajo de materiales de marketing y sistemas de producción de contenido.
Aspectos destacados
- Buena adherencia a prompts complejos: hereda la capacidad de comprensión semántica de la serie GPT, por lo que sigue generando imágenes conforme a la intención incluso ante prompts que combinan sujeto, estilo, texto y restricciones de composición.
- Renderizado más fiable de imágenes con texto: ofrece un buen rendimiento de reproducción y composición en textos de rótulos, envases y maquetas, lo que reduce el retrabajo para corregir letras después de generar la imagen.
- Amplia cobertura de resoluciones y relaciones de aspecto: admite salidas en 1K, 2K y 4K y más de una decena de relaciones desde 1:1 hasta 21:9, de modo que una sola integración se adapta a múltiples formatos de publicación.
- Generación de varias versiones en una sola llamada: permite generar varias imágenes a la vez, lo que facilita comparar propuestas y explorar estilos con un mismo prompt.
Capacidades
Generación de imágenes a partir de prompts de texto: basta con enviar un prompt de hasta 20000 caracteres para generar una imagen, lo que permite convertir descripciones en lenguaje natural directamente en material visual utilizable.
Salida en múltiples resoluciones y relaciones de aspecto: permite elegir entre 1K, 2K y 4K y seleccionar la relación horizontal o vertical según el espacio de publicación; la relación auto y las relaciones extremas como 9:21 y 3:1 se limitan a 1K, y 1:1 no admite 4K.
Salida con fondo transparente: background admite los modos auto, opaque y transparent; las imágenes con fondo transparente pueden usarse directamente para composición y superposición, y este parámetro solo surte efecto en 1K.
Presentación de texto y composición: ofrece un buen rendimiento de renderizado y composición en imágenes que combinan texto y gráficos, adecuado para imágenes comerciales que requieren aspecto de versión final.
Devolución de varias imágenes en una sola respuesta: un solo prompt puede producir varias imágenes de estilo coherente, lo que facilita la comparación rápida de versiones y la selección de la mejor.
Escenarios de uso
- Equipos de marketing: carteles publicitarios y visuales principales: introduzca el tema de la campaña y los requisitos de composición para producir visuales principales de campaña listos para publicar o para un retoque posterior.
- Operación de comercio electrónico: imágenes de producto y renderizado con estilo de fotografía de producto: utilice la descripción del producto como entrada para generar imágenes de producto con estilo fotográfico, destinadas a páginas de detalle, imágenes de catálogo y materiales para redes sociales.
- Equipos de diseño: envases y maquetas con texto: introduzca los textos y la relación entre texto e imagen para producir diseños de envases, rótulos y maquetas con texto en varios idiomas.
- Plataformas de contenido: iteración de varias versiones de propuestas: genere imágenes en lote con el mismo prompt para explorar estilos y entregar las propuestas candidatas a revisión antes de la versión definitiva.
Limitaciones y recomendaciones de selección
Solo genera imágenes; no admite otros modos como vídeo. El fabricante califica la velocidad de generación como media, por lo que no es adecuado para escenarios de interacción en tiempo real muy sensibles a la latencia; las altas resoluciones y la generación por lotes alargan simultáneamente el tiempo de respuesta y elevan el coste de llamada, por lo que conviene sopesarlos según el formato de publicación. En imágenes con texto preciso se recomienda seguir haciendo una revisión manual. Si la necesidad se inclina hacia el razonamiento de composición en escenas complejas o hacia una velocidad de generación extrema, conviene evaluar otros modelos; HiAPI.ai ofrece además una línea de imagen a imagen de esta misma serie, a la que se puede recurrir cuando se necesita partir de una imagen existente. La facturación se calcula por número de imágenes y el importe concreto se rige por el panel de precios.
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/text-to-image
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para gpt-image-2/text-to-image y la ruta default; consulta la tabla de parámetros a continuación.
promptstringObligatoriominLength 1maxLength 20000Texto de indicación, obligatorio, longitud máxima 20000 caracteres.
backgroundstringOpcionalModo de fondo, este parámetro solo se admite en resolución 1K.
autoopaquetransparentresolutionstringOpcionalPredeterminado: "1K"Resolución de la imagen generada, por defecto 1K. Cuando aspect_ratio es auto, solo se admite 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. Si se omite o se establece en auto, 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/text-to-image
routestringOpcionalValor fijo actual: beta
inputobjectObligatorio
Objeto de parámetros de negocio para gpt-image-2/text-to-image y la ruta beta; consulta la tabla de parámetros a continuación.
sizestringOpcionalPredeterminado: "auto"pattern ^(auto|[1-9][0-9]{2,4}x[1-9][0-9]{2,4})$Output image size. Use auto or a compliant WIDTHxHEIGHT value such as 2048x2048.
promptstringObligatoriomaxLength 20000Text prompt describing the image to generate. Max 20000 characters.
callbackobjectOpcional
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/text-to-image
routestringOpcionalValor fijo actual: ext
inputobjectObligatorio
Objeto de parámetros de negocio para gpt-image-2/text-to-image y la ruta ext; consulta la tabla de parámetros a continuación.
promptstringObligatoriominLength 1maxLength 20000图像生成提示词 Max 20000 characters.
qualitystringObligatorioPredeterminado: "low"lowmediumhighresolutionstringObligatorioPredeterminado: "1K"1K2K4Kaspect_ratiostringOpcionalPredeterminado: "1:1"输出画幅比例
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/text-to-image",
"input": {
"prompt": "…",
"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/text-to-image",
input: {
"prompt": "…",
"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/text-to-image",
"input": {
"prompt": "…",
"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/text-to-image@beta",
"input": {
"size": "auto",
"prompt": "…"
}
}' 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/text-to-image@beta",
input: {
"size": "auto",
"prompt": "…"
}
}),
});
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/text-to-image@beta",
"input": {
"size": "auto",
"prompt": "…"
}
},
)
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/text-to-image@ext",
"input": {
"prompt": "…",
"quality": "low",
"resolution": "1K",
"aspect_ratio": "1:1"
}
}' 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/text-to-image@ext",
input: {
"prompt": "…",
"quality": "low",
"resolution": "1K",
"aspect_ratio": "1:1"
}
}),
});
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/text-to-image@ext",
"input": {
"prompt": "…",
"quality": "low",
"resolution": "1K",
"aspect_ratio": "1:1"
}
},
)
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 kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
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
-
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
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
-
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 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
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 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
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
BRIA Eraser Bria $0.058 /imagen -
FASHN Tryon v1.6 FASHN $0.107 /imagen -
FLUX 1.1 Pro Black Forest Labs $0.050 /imagen -
Wan 2.7 Image Alibaba $0.035 /imagen -
Nano Banana 2 Lite Google $0.033 /imagen -
Grok Imagine Quality xAI $0.070 /imagen -
Grok Imagine xAI $0.011 /segundo -
Ideogram V4 Ideogram $0.050 /imagen -
FLUX 3 Image Black Forest Labs $0.041 /imagen -
Recraft V4.1 Recraft $0.010 /imagen -
Qwen Image 2.1 Alibaba $0.020 /imagen -
BRIA Product Shot Bria $0.058 /imagen

