Introducción
La generación de texto a imagen de Sunburst parte de tu descripción, sin una imagen de entrada. La opción de precisión ofrece cinco ajustes de calidad para controlar el detalle y tamaños de salida de hasta unos 8,3 megapíxeles.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Imagen |
| Editor | OpenAI |
| Fecha de lanzamiento | 2026-11-05 |
| Modelo de API | gpt-image-2.6-sunburst |
| Endpoints públicos | openai/gpt-image-2.6-sunburst/text-to-image; openai/gpt-image-2.6-sunburst/edit |
| Calidad | low, medium (predeterminado), high, xhigh, max |
| Resolución | 1k: unos 1 MP; 2k: unos 3,7 MP; 4k: unos 8,3 MP |
| Dimensiones en 16:9 | 2k: 2560 x 1440; 4k: 3840 x 2160 |
| Proporciones | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| Cantidad de resultados | 1–10 imágenes por solicitud |
| Fuentes para edición | 1–16 imágenes de entrada |
| Máscara | PNG opcional, con las dimensiones de la primera imagen; los píxeles transparentes indican dónde repintar |
| Fondo | auto, opaque, transparent; la transparencia requiere PNG o WebP |
| Formatos de archivo | PNG (predeterminado), JPEG, WebP; GIF (solo texto a imagen) |
Funciones y aspectos destacados
Giro en el balcón
El bucle de Sunburst sigue el giro desde la vista de la ciudad hasta una sonrisa a la cámara en un balcón nocturno. La secuencia concreta de acciones ayuda a Sunburst a planificar un bucle con precisión.
Brindis en el club de jazz
La animación de Sunburst enlaza una copa que se eleva, un guiño juguetón y una sonrisa en el bar de jazz. La secuencia concreta de acciones ayuda a Sunburst a planificar un bucle con precisión.
Cambio de abrigo en París
La edición de Sunburst detalla qué conservar del sujeto antes de pedir un abrigo y un entorno lluvioso.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Descripción de escena obligatoria para Sunburst de hasta 5.000 caracteres, sin texto predeterminado; los prompts muy largos añaden un pequeño cargo por token. mínimo 1 caracteres · máximo 5000 caracteres |
aspect_ratio | No | Sunburst usa 1:1 de forma predeterminada para imágenes fijas entre 15 proporciones de 1:3 a 3:1; para GIF, debes indicar |
resolution | No | Sunburst: para imágenes fijas, usa 1k, 2k o 4k; en GIF, resolution indica el tamaño de un fotograma: 512 (unos 0,26 MP) admite hasta 16 fotogramas y 768 (unos 0,59 MP), hasta 12. |
quality | No | Ajusta el detalle de Sunburst en low, medium (predeterminado), high, xhigh o max; los niveles superiores aumentan el detalle, el tiempo de renderizado y el precio. |
reasoning_effort | No | Sunburst: |
num_outputs | No | Pide de 1 a 10 imágenes de Sunburst por solicitud; aquí no se especifica una cantidad predeterminada y se factura cada imagen de salida. |
background | No | Sunburst admite auto, opaque y transparent; la transparencia requiere PNG o WebP y no puede combinarse con GIF. |
output_format | No | Sunburst entrega png de forma predeterminada y admite jpeg, webp o gif; GIF animado solo está disponible en texto a imagen y no admite fondo transparente. |
frame_count | No | Sunburst: |
frame_duration_ms | No | Sunburst: |
output_quality | No | Elige la compresión JPEG o WebP de Sunburst entre 0 y 100: un valor más alto conserva más detalle en un archivo más pesado, PNG y GIF la ignoran y el costo de Sunburst no cambia. |
Precios
Sunburst factura cada imagen según su nivel de calidad y resolución; al pedir más imágenes, ese cargo se multiplica. Las ediciones suman un pequeño cargo por cada imagen de entrada, mientras que los prompts muy largos añaden un pequeño cargo por token. Las solicitudes rechazadas de Sunburst no se cobran. En Sunburst, un GIF se factura por hojas de 8 fotogramas según el nivel de calidad: 9 fotogramas requieren 2 hojas.
| Resolución | Calidad: low | Calidad: medium | Calidad: high | Calidad: xhigh | Calidad: max |
|---|---|---|---|---|---|
| $0.02232 / imagen | $0.03915 / imagen | $0.04743 / imagen | $0.08433 / imagen | $0.18972 / imagen |
| $0.027 / imagen | $0.04752 / imagen | $0.05742 / imagen | $0.10206 / imagen | $0.22941 / imagen |
| $0.04131 / imagen | $0.07299 / imagen | $0.08847 / imagen | $0.15723 / imagen | $0.35379 / imagen |
| $0.04392 / imagen | $0.07776 / imagen | $0.09432 / imagen | $0.1674 / imagen | $0.37638 / imagen |
| $0.07479 / imagen | $0.13221 / imagen | $0.16011 / imagen | $0.28512 / imagen | $0.64044 / imagen |
Casos de uso
Imágenes para campañas turísticas
Crea un cartel costero con un destino identificado, un título breve y una paleta de colores definida.
Imágenes de menús de cafetería
Describe una composición en pizarra con los platos entre comillas y un ambiente matutino bien definido.
Ajustes de retratos
Lleva un retrato de origen a una calle lluviosa y pide que mantenga la continuidad con la imagen inicial.
Guía de prompts y consejos prácticos
Define la escena
Describe el sujeto, los materiales y la luz; después, pon entre comillas los textos breves que necesites.
Elige detalle y dimensiones
Empieza con calidad medium y selecciona 1k, 2k o 4k según dónde vayas a usar la imagen.
Detalla el cambio
Para editar, coloca primero la imagen de origen y explica qué conservar antes de indicar qué reemplazar.
Marca una zona concreta
Si el cambio corresponde a una zona específica, proporciona una máscara PNG del mismo tamaño que la primera imagen.
Introducción
Con Sunburst, define con precisión la escena y la secuencia de movimiento antes de generar.
Funciones
- Sunburst ofrece 1k, 2k y 4k para imágenes fijas, con cinco niveles de calidad.
- Bucles GIF con Sunburst: describe el movimiento y su repetición, selecciona
output_format: gif e indicaaspect_ratio. - Sunburst: para imágenes fijas, usa 1k, 2k o 4k; en GIF, resolution indica el tamaño de un fotograma: 512 (unos 0,26 MP) admite hasta 16 fotogramas y 768 (unos 0,59 MP), hasta 12.
- Sunburst:
frame_countadmite de 2 a 16 fotogramas, con 9 como valor predeterminado; el límite depende del tamaño de fotograma elegido. - Sunburst:
frame_duration_msdefine de 20 a 2000 ms por fotograma; el valor predeterminado es 200 ms. - En Sunburst, un GIF se factura por hojas de 8 fotogramas según el nivel de calidad: 9 fotogramas requieren 2 hojas.
- Sunburst entrega png de forma predeterminada y admite jpeg, webp o gif; GIF animado solo está disponible en texto a imagen y no admite fondo transparente.
Consejos
- Para Sunburst, ajusta
reasoning_effortsegún la composición: high es el valor predeterminado y favorece el texto denso; planificar más tarda más, sin cambiar el costo.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "openai/gpt-image-2.6-sunburst/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"background": "auto",
"resolution": "1k",
"num_outputs": 1,
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
