OpenAI

GPT Image 2.5

gpt-image-2.5-sunburst/image-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

Ruta

default pro

gpt-image-2.5-flare/image-to-image gpt-image-2.5-flare/text-to-image gpt-image-2.5-sunburst/image-to-image gpt-image-2.5-sunburst/text-to-image

Probar gpt-image-2.5-sunburst/image-to-image

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

gpt-image-2.5-sunburst/image-to-image per image

Especificaciones	Precio unitario
1K	$0.050
2K	$0.080
4K	$0.120

Descripción general

gpt-image-2.5-sunburst es una línea de edición de imágenes dirigida a desarrolladores que necesitan realizar modificaciones y ampliaciones de alta fidelidad sobre imágenes existentes. Recibe de una a dieciséis imágenes de referencia junto con una instrucción de edición, genera imágenes en los niveles de resolución 1K, 2K y 4K, y admite la especificación de la relación de aspecto y el fondo transparente, lo que lo hace adecuado para flujos de trabajo de retoque de diseño en los que se debe mantener la coherencia del sujeto a lo largo de múltiples iteraciones. Sunburst intercambia un mayor tiempo de procesamiento por una mayor precisión en la restauración de detalles.

Aspectos destacados

Línea de edición orientada a la precisión: la variante Sunburst intercambia un mayor tiempo de procesamiento por solicitud por una restauración de detalles más fina, adecuada para tareas de edición sensibles a la calidad del resultado final.
Entrada conjunta de hasta dieciséis imágenes de referencia: en una sola solicitud se pueden enviar de una a dieciséis imágenes de origen o de referencia, lo que facilita pasar al modelo la información del sujeto, el estilo y la composición en conjunto.
Cuatro niveles de formato y resolución seleccionables: la salida admite tres niveles de resolución (1K, 2K y 4K) y trece relaciones de aspecto, lo que permite ajustarse directamente a las especificaciones del producto final y reduce el recorte secundario.
Fondo transparente disponible en 1K: el modo de fondo transparente está limitado a la resolución 1K; los materiales transparentes generados pueden pasar directamente al flujo de composición posterior.

Descripción de capacidades

Edición condicionada por múltiples referencias: mediante image_urls se envían de una a dieciséis imágenes JPEG, PNG o WebP, junto con una instrucción de edición de hasta veinte mil caracteres, para reescribir, sustituir y ampliar materiales existentes.

Control de resolución y formato: resolution selecciona el nivel de salida 1K, 2K o 4K; aspect_ratio admite trece relaciones, de 1:1 a 21:9, y el valor predeterminado auto deja que el modelo decida.

Generación con fondo transparente: background puede configurarse como transparent, opaque o auto; el modo transparente solo está disponible en resolución 1K, lo que facilita producir directamente materiales sin necesidad de recorte.

Restauración refinada de detalles: la variante Sunburst prioriza la fidelidad al detalle y se aproxima más a las imágenes de referencia en textura, iluminación y estructura de composición, lo que la hace adecuada para rondas de edición con altas exigencias sobre el resultado final.

Casos de uso

Equipos de diseño que renuevan por lotes materiales de marca existentes: se envían las piezas visuales de marca como imágenes de referencia, se sustituyen textos y colores siguiendo una instrucción uniforme y se produce un conjunto de materiales para campañas.
Operaciones de comercio electrónico que retocan imágenes de producto y de escena: a partir de fotografías reales del producto se generan imágenes finales con fondo o escena cambiados, listas para páginas de detalle de producto y materiales publicitarios.
Creativos que iteran varias veces sobre una misma imagen: se sigue introduciendo el resultado actual como entrada y se añaden instrucciones hasta converger en la versión final, produciendo piezas de diseño entregables directamente.
Producción de materiales que requieren gráficos con fondo transparente: con una imagen de referencia y una instrucción de edición se genera una imagen 1K con fondo transparente, que se incorpora como capa a la composición y maquetación posteriores.

Limitaciones y recomendaciones de selección

Sunburst prioriza la precisión, por lo que cada solicitud tarda más y no es adecuado para escenarios de generación de imágenes con baja latencia o concurrencia muy alta; las salidas en 2K y 4K aumentan aún más el coste de cómputo y de espera; el fondo transparente se limita a 1K. Las composiciones con texto pequeño denso o leyendas complejas siguen siendo propensas a errores, por lo que se recomienda revisar manualmente la salida. Si se requiere despliegue local, ajuste fino propio o inferencia sin conexión, este modelo de código cerrado no puede satisfacerlo y habrá que optar por otra solución. Cuando se necesite generar imágenes por lotes con rapidez, puede considerarse la línea Flare de la misma familia.

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-sunburst/image-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para gpt-image-2.5-sunburst/image-to-image y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 1maxLength 20000

Instrucción de generación o edición que describe el contenido que se debe generar o modificar a partir de la imagen de origen, en forma de cadena, con una longitud máxima de 20000 caracteres.

backgroundstringOpcional

Modo de fondo, en forma de cadena; solo se admite con resolución 1K, omítase este parámetro en 2K/4K.

Opciones:transparentopaqueauto

image_urlsarrayObligatoriominItems 1maxItems 16

Matriz de imágenes de origen o de referencia, cuyos elementos son imágenes en formato JPEG, PNG o WebP, en un número de 1 a 16.

Array [ string ]

resolutionstringOpcionalPredeterminado: "1K"

Nivel de resolución de salida, en forma de cadena, por defecto 1K; cuando background es auto/opaque/transparent solo se admite 1K.

Opciones:1K2K4K

aspect_ratiostringOpcionalPredeterminado: "auto"

Relación de aspecto de salida, en forma de cadena, por defecto auto; si se omite, también se trata como auto.

Opciones:auto1:13:22:34:33:416:99:16

Mostrar todo (5)

21:927:1616:279:88:9

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-sunburst/image-to-image",
  "input": {
    "prompt": "…",
    "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.5-sunburst/image-to-image",
    input: {
      "prompt": "…",
      "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.5-sunburst/image-to-image",
        "input": {
          "prompt": "…",
          "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

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