OpenAI
GPT Image 2.5
gpt-image-2.5-sunburst
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-sunburst
Entrada
Creaciones
Ver todas las creacionesSalida
imagePrecios
gpt-image-2.5-sunburst 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-sunburst es una variante de la familia de imágenes gpt-image-2.5 de OpenAI orientada a la precisión, que admite tanto la generación de imágenes a partir de texto como la edición de imágenes, y puede invocarse a través de la interfaz unificada de HiAPI.ai. Ha mejorado en la representación de iluminación y materiales, la consistencia del sujeto de referencia y el seguimiento de instrucciones visuales complejas, y admite salidas de hasta 3840 px y fondos transparentes. Es adecuada para diseño creativo con altos requisitos de fidelidad de detalles, creación de materiales de marca y flujos de trabajo de imágenes que requieren retoques repetidos.
Características clave
- Restauración de detalles con prioridad en la precisión: intercambia un tiempo de generación único más largo por detalles y texturas más refinados, ideal para tareas que exigen alta calidad en la imagen final.
- Consistencia del sujeto en ediciones múltiples: al modificar repetidamente a partir de una imagen de referencia, el sujeto y la composición tienden a mantenerse más consistentes, reduciendo el retrabajo en cada ronda.
- Alta resolución y fondo transparente: admite tamaños de hasta 3840 px y puede generar fondos transparentes, reduciendo los costes de recorte y composición posteriores.
Descripción de capacidades
Generación de imágenes y edición en la misma variante: la misma variante puede generar imágenes directamente a partir de un prompt o recibir una imagen de referencia para realizar edición, composición o mantener el estilo y el sujeto, sin necesidad de cambiar de modelo.
Entrada de múltiples imágenes de referencia: se pueden enviar hasta 16 imágenes de referencia a la vez para composición de múltiples materiales o para mantener el sujeto y el estilo entre imágenes, adecuado para escenarios que requieren combinar varios elementos visuales.
Relación de aspecto y tamaño en píxeles seleccionables: admite desde relaciones como 1:1 y 16:9 hasta tamaños en píxeles de nivel 2048 y 3840, o puede dejarse que el modelo lo decida automáticamente, lo que facilita la alineación con páginas de destino y espacios de material.
Control de calidad y formato de salida: la calidad se puede seleccionar en varios niveles desde low hasta max, lo que afecta al detalle, la velocidad y la tarifa de facturación; la salida admite png, jpeg y webp, y se puede elegir fondo automático o transparente.
Composiciones complejas y prompts largos: el límite de prompt es de 20000 caracteres, lo que permite albergar instrucciones visuales y descripciones de composición extensas, adecuado para imágenes e infografías de estructura compleja.
Escenarios de aplicación
- Equipos de diseño de marca y marketing: borradores creativos refinados: introduce requisitos de diseño e imágenes de referencia para producir materiales visuales de marca en alta resolución, destinados a sitios web, presentaciones y materiales publicitarios.
- Flujo de trabajo de diseño: retoque iterativo sobre imágenes existentes: envía la imagen original y las indicaciones de modificación, itera ronda a ronda manteniendo la consistencia del sujeto y la composición, y produce versiones finales entregables para revisión de diseño.
- Comercio electrónico y páginas de producto: composición con múltiples elementos: combina varias imágenes de producto y referencias de escena como entrada para producir imágenes principales listas para publicar en la tienda.
- Producción de materiales: elementos con fondo transparente: genera elementos gráficos con fondo transparente según el prompt, produciendo materiales que se pueden superponer directamente en páginas o carteles.
Limitaciones y recomendaciones de selección
sunburst tiene como objetivo la precisión, por lo que cada solicitud tarda más y no es adecuada para escenarios de baja latencia o generación masiva de imágenes con alta concurrencia; la salida en alta resolución aumenta aún más el cómputo y el tiempo de espera. Las imágenes con mucho texto de tamaño pequeño o leyendas complejas siguen siendo escenarios de alta dificultad, por lo que se recomienda revisión humana. Si se necesita un equilibrio entre velocidad y calidad o generación masiva de imágenes, se puede considerar la variante flare de la misma familia. El uso de todos los contenidos generados debe cumplir las restricciones de la política de uso de OpenAI; el modelo es de código cerrado y no admite despliegue local ni ajuste fino propio.
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-sunburst
routestringOpcionalValor fijo actual: pro
inputobjectObligatorio
Objeto de parámetros de negocio para gpt-image-2.5-sunburst y la ruta pro; consulta la tabla de parámetros a continuación.
promptstringObligatoriominLength 1maxLength 20000Prompt que describe la imagen a generar, o indica las modificaciones que deben aplicarse a las imágenes de referencia; tipo cadena, máximo 20000 caracteres.
qualitystringOpcionalPredeterminado: "medium"Nivel de calidad de la imagen, que determina el detalle de salida, la velocidad de generación y el precio; tipo cadena, valor predeterminado medium.
lowmediumhighxhighmaxautobackgroundstringOpcionalPredeterminado: "auto"Modo de fondo, que permite elegir entre fondo automático, transparente u opaco; tipo cadena, valor predeterminado auto.
autotransparentopaqueimage_urlsarrayOpcionalminItems 1maxItems 16Arreglo de imágenes de referencia, cuyos elementos son direcciones de imagen; al proporcionarse se usan para editar, componer o mantener el sujeto y el estilo, y si no se proporcionan, se trata de generación puramente a partir de texto.
Array [ string ]
aspect_ratiostringOpcionalPredeterminado: "1:1"Relación de aspecto o tamaño en píxeles de salida; tipo cadena, valor predeterminado 1:1; si se establece en auto, el modelo decide según la solicitud.
1:13:22:34:33:416:99:16autoMostrar todo (10)
1024x10241536x10241024x15361536x11521152x15362048x20482048x11521152x20483840x21602160x3840output_formatstringOpcionalPredeterminado: "webp"Formato de la imagen de salida; tipo cadena, valor predeterminado webp.
pngjpegwebpcallbackobjectOpcional
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-sunburst@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-sunburst@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-sunburst@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
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
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-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 kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
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
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
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
Nano Banana Pro Google $0.057 /imagen -
Qwen Image 2.1 Alibaba $0.020 /imagen -
FLUX 1.1 Pro Black Forest Labs $0.050 /imagen -
FASHN Tryon v1.6 FASHN $0.107 /imagen -
GPT Image 2 OpenAI $0.007 /imagen -
Nano Banana 2 Google $0.036 /imagen -
Wan 2.7 Image Alibaba $0.035 /imagen -
Nano Banana Google $0.021 /imagen -
Qwen Image 2.0 Alibaba $0.042 /imagen -
Nano Banana 2 Lite Google $0.033 /imagen -
BRIA Eraser Bria $0.058 /imagen -
Grok Imagine Image 2.0 xAI $0.052 /imagen











