OpenAI

GPT Image 2.5

gpt-image-2.5-flare

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

Ruta

default pro

gpt-image-2.5-flare gpt-image-2.5-sunburst

Probar gpt-image-2.5-flare

Entrada

Creaciones

Ver todas las creaciones

Salida

image

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

gpt-image-2.5-flare per image

Especificaciones	Precio unitario
low	$0.0172
medium	$0.0672
high	$0.1829
xhigh	$0.3572
max	$0.7143
auto	$0.3572

Descripción general

gpt-image-2.5-flare es la versión de la familia de imágenes gpt-image-2.5 de OpenAI que equilibra velocidad y calidad, y se invoca en HiAPI.ai mediante una interfaz unificada que admite tanto la generación de imágenes a partir de texto como la edición de imágenes basada en referencias. Es adecuada para la producción de imágenes comerciales que requieren resultados estables, la generación de contenido por lotes y los flujos de retoque de imágenes, y puede generar imágenes de hasta 3840 px de resolución, con fondo transparente y en diversas proporciones y formatos.

Puntos clave

Prioridad a la velocidad sin renunciar a la calidad: frente a la generación anterior GPT-Image-2, mejora la calidad y a la vez reduce notablemente la latencia, ideal para tareas por lotes con requisitos de ritmo de generación.
Generación y edición en la misma línea: el mismo modelo puede generar desde cero a partir de un prompt o recibir imágenes de referencia para editar, componer y mantener el sujeto y el estilo.
Amplia cobertura de proporciones y resoluciones: admite relaciones como 1:1, 16:9 y 9:16, así como tamaños en píxeles de hasta 3840x2160 con salida directa.
Fondo transparente y formato controlable: permite elegir fondo transparente y formatos de salida png, jpeg y webp, lo que reduce el posprocesamiento de los recursos.

Capacidades

Generación a partir de texto: genera imágenes con un prompt descriptivo y admite prompts estructurados largos y requisitos de maquetación complejos, ideal para producir imágenes utilizables directamente a partir de texto.

Edición y conservación con imágenes de referencia: permite pasar hasta 16 imágenes de referencia para editar, componer o mantener el sujeto y el estilo durante las modificaciones, lo que reduce los ajustes repetidos de parámetros.

Selección de nivel de calidad: ofrece niveles de calidad de low a max y auto, de modo que los desarrolladores pueden elegir según el escenario entre velocidad de generación y nivel de detalle.

Control de resolución y proporción: permite especificar la relación de aspecto o el tamaño exacto en píxeles, con niveles como 1024, 1536, 2048 y 3840; auto deja que el modelo lo decida.

Formato de salida y fondo: admite tres formatos (png, jpeg y webp) y configuraciones de fondo automático, transparente u opaco, produciendo directamente archivos de recursos utilizables.

Casos de uso

Imágenes comerciales para equipos de marca y marketing: a partir de descripciones visuales de marca o imágenes de referencia, se generan imágenes para presentaciones, landing pages y anuncios, y se entregan por lotes al repositorio de recursos mediante la interfaz unificada.
Generación de imágenes para redes sociales por creadores de contenido: se envían prompts por lotes según el guion o el tema para obtener imágenes en varias proporciones, destinadas a publicaciones en redes sociales y planificación de contenido.
Creación de recursos para ecommerce y páginas de producto: con imágenes de referencia del producto e instrucciones de modificación como entrada, se generan imágenes de presentación contextualizadas para usarlas directamente en páginas de detalle de producto y en recursos de búsqueda visual.
Retoque iterativo en flujos de diseño: edición en varias rondas sobre imágenes existentes manteniendo la coherencia del sujeto y la maquetación, para validación de prototipos e iteración de bocetos de diseño.

Limitaciones y recomendaciones de elección

Al ser un modelo de código cerrado, no se puede desplegar localmente ni ajustar por cuenta propia, y la salida depende de la llamada a la interfaz. La generación en alta resolución implica un mayor coste computacional y de tiempo; el texto denso de cuerpo pequeño y las leyendas complejas siguen siendo escenarios propensos a errores que requieren revisión humana. Si la tarea exige una fidelidad de detalle muy alta y se puede aceptar una espera mayor, gpt-image-2.5-sunburst es más adecuado; si se busca una generación diaria por lotes con baja latencia, esta línea es la opción predeterminada. El cumplimiento del contenido debe seguir las políticas de uso correspondientes.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El 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-KeystringOpcional

Clave 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.

Clave de idempotencia

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

modelstringObligatorio

Valor fijo actual: gpt-image-2.5-flare

routestringOpcional

Valor fijo actual: pro

inputobjectObligatorio

Objeto de parámetros de negocio para gpt-image-2.5-flare y la ruta pro; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 1maxLength 20000

Describe el contenido de la imagen que se va a generar, o explica las modificaciones que deben aplicarse a la imagen de referencia; se proporciona como cadena de texto y admite un máximo de 20000 caracteres.

qualitystringOpcionalPredeterminado: "medium"

Controla el nivel de detalle, la velocidad de generación y el rango de precio de la imagen de salida; se proporciona como cadena de texto y su valor predeterminado es medium.

Opciones:lowmediumhighxhighmaxauto

backgroundstringOpcionalPredeterminado: "auto"

Controla el modo de fondo de la imagen de salida (automático, transparente u opaco); se proporciona como cadena de texto y su valor predeterminado es auto.

Opciones:autotransparentopaque

image_urlsarrayOpcionalminItems 1maxItems 16

Array opcional de imágenes de referencia; una vez proporcionado, se utiliza para editar o componer las imágenes, o para mantener el sujeto y el estilo; cada elemento es una dirección de imagen.

Array [ string ]

aspect_ratiostringOpcionalPredeterminado: "1:1"

Controla la relación de aspecto o el tamaño en píxeles de la imagen de salida; se proporciona como cadena de texto y su valor predeterminado es 1:1; al establecerlo en auto, el modelo lo decide según la solicitud.

Opciones:1:13:22:34:33:416:99:16auto

Mostrar todo (10)

1024x10241536x10241024x15361536x11521152x15362048x20482048x11521152x20483840x21602160x3840

output_formatstringOpcionalPredeterminado: "webp"

Controla el formato de archivo de la imagen de salida; se proporciona como cadena de texto y su valor predeterminado es webp.

Opciones:pngjpegwebp

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

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.

urlstringObligatorio

Obligatorio 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.

Opciones:final

storagestringOpcionalPredeterminado: "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.

Opciones:temppersistent

Ejemplos 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@pro",
  "input": {
    "prompt": "…",
    "quality": "medium",
    "background": "auto",
    "aspect_ratio": "1:1",
    "output_format": "webp"
  }
}'

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@pro",
    input: {
      "prompt": "…",
      "quality": "medium",
      "background": "auto",
      "aspect_ratio": "1:1",
      "output_format": "webp"
    }
  }),
});
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@pro",
        "input": {
          "prompt": "…",
          "quality": "medium",
          "background": "auto",
          "aspect_ratio": "1:1",
          "output_format": "webp"
        }
    },
)
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

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre 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.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

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.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos 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

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripció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"
    }
  }
}