OpenAI
GPT Image 2.5
gpt-image-2.5-flare/text-to-image
Modelo de generación y edición de imágenes de OpenAI con dos niveles: Flare se centra en la velocidad y Sunburst en la precisión, cubriendo tanto la generación de imágenes a partir de texto como la edición iterativa de imágenes
Probar gpt-image-2.5-flare/text-to-image
Entrada
Creaciones
Ver todas las creacionesSalida
imagePrecios
gpt-image-2.5-flare/text-to-image per image
| Especificaciones | Precio unitario |
|---|---|
| 1K | $0.050 |
| 2K | $0.080 |
| 4K | $0.120 |
Descripción general
gpt-image-2.5-flare es la línea de texto a imagen de la familia de generación de imágenes de OpenAI, que busca un equilibrio entre velocidad y calidad, adecuada para aplicaciones que necesitan generar imágenes por lotes. Acepta prompts de hasta 20000 caracteres, permite especificar resoluciones de 1K a 4K y varias relaciones de aspecto, y admite salida con fondo transparente en 1K. En comparación con la generación anterior, esta versión reduce la latencia por imagen mientras mantiene una mayor calidad de generación, por lo que es adecuada para escenarios que exigen rendimiento, como imágenes para comercio electrónico, material para redes sociales y validación rápida de prototipos.
Aspectos destacados
- Línea de texto a imagen que combina velocidad y calidad: Flare se posiciona como la opción predeterminada para la mayoría de las aplicaciones; su calidad supera a la de la generación anterior y reduce notablemente el tiempo de generación por solicitud, lo que la hace adecuada para la generación de imágenes con alta concurrencia.
- Fondo transparente directo en 1K: con resolución 1K y background establecido en transparent, se obtiene directamente una imagen con fondo transparente, lo que reduce los pasos posteriores de recorte y composición.
- Resolución y formato flexibles: admite tres niveles de resolución (1K, 2K y 4K) y más de diez relaciones de aspecto, de modo que se puede elegir directamente la especificación de la imagen según el canal de publicación.
Descripción de capacidades
Texto a imagen con prompts largos: un solo prompt puede tener hasta 20000 caracteres, lo que facilita describir diseños complejos e información estructurada; la imagen se genera directamente a partir del texto, sin necesidad de preparar imágenes de referencia.
Control de resolución y relación de aspecto: se puede elegir el nivel de salida entre 1K, 2K y 4K, y especificar el formato entre proporciones como 1:1, 16:9, 21:9 y 9:16, generando de una vez la especificación adecuada según el lugar de destino.
Salida con fondo transparente: con resolución 1K se puede establecer background en transparent para generar una imagen con fondo transparente, adecuada para superponer materiales y para flujos posteriores de composición.
Casos de uso
- Generación por lotes de imágenes de productos por equipos de comercio electrónico y operaciones: a partir del texto con los puntos de venta del producto, se generan imágenes por lotes con la proporción del canal, para usarlas directamente en páginas de detalle de producto y material publicitario.
- Producción rápida de imágenes de contenido por creadores de redes sociales: con prompts breves y proporciones 9:16 o 1:1 se generan imágenes complementarias, acortando el ciclo desde la elección del tema hasta la publicación.
- Validación de prototipos visuales por equipos de producto: antes de la revisión de requisitos, se comparan rápidamente varias direcciones visuales con texto a imagen de bajo costo y baja latencia, y tras decidir el enfoque se pasa al refinado.
- Generación de materiales con fondo transparente por diseñadores: con el modo de fondo transparente en 1K se producen elementos gráficos que se pueden superponer directamente, para carteles, páginas y composición de vídeo.
Limitaciones y recomendaciones de selección
Esta línea solo admite texto a imagen; no permite editar a partir de imágenes de referencia ni refinar de forma iterativa, por lo que esas necesidades deben cubrirse con la línea de edición de imágenes de la misma familia. El fondo transparente solo está disponible en 1K; al elegir 2K o 4K no se puede especificar el modo de fondo. La salida en 4K implica un mayor costo computacional y de tiempo, por lo que en escenarios por lotes de baja latencia se recomienda priorizar 1K o 2K. Los diseños con texto denso en tamaños pequeños o leyendas complejas siguen siendo propensos a errores y requieren revisión humana antes de su publicación; el modelo es una interfaz de código cerrado, no admite despliegue local ni ajuste fino, y el uso del contenido debe cumplir los requisitos de cumplimiento correspondientes.
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.5-flare/text-to-image
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para gpt-image-2.5-flare/text-to-image y la ruta default; consulta la tabla de parámetros a continuación.
promptstringObligatoriominLength 1maxLength 20000Indicación de generación de imágenes, utilizada para describir el contenido visual que se desea generar; es una cadena de texto con una longitud máxima de 20000 caracteres.
backgroundstringOpcionalModo de fondo, valor de tipo cadena. Solo es compatible con resolución 1K; al usar resoluciones 2K/4K, omita este parámetro.
transparentopaqueautoresolutionstringOpcionalPredeterminado: "1K"Nivel de resolución de salida, valor de tipo cadena, predeterminado 1K. Cuando background es auto, opaque o transparent, solo se admite 1K.
1K2K4Kaspect_ratiostringOpcionalPredeterminado: "auto"Relación de aspecto de salida, valor de tipo cadena, predeterminado auto; si se omite, se trata como auto.
auto1:13:22:34:33:416:99:16Mostrar todo (5)
21:927:1616:279:88:9callbackobjectOpcional
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.5-flare/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.5-flare/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.5-flare/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"
} 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 →-
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 kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
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
-
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 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
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
FLUX.1 Schnell Black Forest Labs $0.005 /imagen -
851 Labs Background Remover 851 Labs $0.002 /imagen -
Nano Banana 2 Google $0.036 /imagen -
FLUX.1 Fill Pro Black Forest Labs $0.071 /imagen -
FASHN Tryon v1.6 FASHN $0.107 /imagen -
Recraft V4.1 Recraft $0.010 /imagen -
GPT Image 2 OpenAI $0.007 /imagen -
Grok Imagine xAI $0.011 /segundo -
Grok Imagine Quality xAI $0.070 /imagen -
Krea 2 Medium Turbo Krea $0.021 /imagen -
Ideogram V3 Character Ideogram $0.090 /imagen -
Imagen 4 Google $0.030 /imagen



