Introducción
La edición de Sunburst admite de 1 a 16 imágenes de origen y una instrucción escrita sobre qué conservar o reemplazar. Una máscara PNG del mismo tamaño permite identificar la zona que se repintará en la primera imagen.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| 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í | Instrucción de edición 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 |
image_urls | Sí | Proporciona de 1 a 16 URL de imágenes de entrada para Sunburst, sin fuente predeterminada; identifícalas como Image 1, Image 2 y así sucesivamente, y considera un pequeño cargo… mínimo 1 elementos · máximo 16 elementos |
mask_url | No | Máscara PNG opcional de Sunburst, ausente de forma predeterminada y del mismo tamaño que la primera imagen; los píxeles transparentes marcan la zona que se repintará y la máscar… |
markup_url | No | Sunburst: |
aspect_ratio | No | Elige una de las 15 proporciones entre 1:3 y 3:1. |
resolution | No | Elige un tamaño de Sunburst: 1k (unos 1 MP), 2k (unos 3,7 MP) o 4k (unos 8,3 MP); aquí no se especifica un valor predeterminado y este nivel modifica el precio. |
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 | Las opciones de fondo de Sunburst son auto, opaque y transparent, sin un valor predeterminado especificado aquí; usa PNG o WebP para obtener transparencia, sin cargo adicional p… |
output_format | No | Sunburst codifica los archivos como png de forma predeterminada y también ofrece jpeg y webp; la elección del formato no afecta al precio. |
output_quality | No | Si guardas una edición de Sunburst en JPEG o WebP, la compresión va de 0 a 100; en PNG no se usa y el costo es el mismo. |
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.
| 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.04131 / imagen | $0.07299 / imagen | $0.08847 / imagen | $0.15723 / imagen | $0.35379 / 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
GPT Image 2.6 Sunburst Edición de imágenes modifica una imagen de origen mediante una instrucción escrita. La opción de precisión se centra en la fidelidad y la estabilidad de los detalles a lo largo de ediciones sucesivas, y admite de 1 a 16 imágenes de entrada.
Coloca primero la imagen que quieras modificar y explica la función de cada referencia adicional. Una máscara PNG opcional marca la zona que se repintará; en nuestras pruebas, un cambio de vestuario y ubicación conservó la apariencia de la persona.
Funciones y características destacadas
- Ediciones con anotaciones en Sunburst: usa
markup_urlcon un PNG transparente del tamaño de la primera imagen; cuenta como entrada adicional y excluyemask_url. - Referencias numeradas: llama a las fuentes Image 1, Image 2 y los números siguientes para explicar qué aporta cada una.
- Repintado local: los píxeles transparentes de una máscara PNG del mismo tamaño identifican la zona que cambiará en la primera fuente.
- Conservación de la forma: omitir
aspect_ratiomantiene la forma de la primera imagen en 1k; 2k y 4k requieren seleccionar una proporción. - Controles de detalle: los cinco ajustes de calidad permiten dedicar más tiempo de renderizado y costo a obtener un mayor detalle.
- Entrega flexible: guarda las ediciones como PNG, JPEG o WebP; PNG y WebP admiten transparencia.
Casos de uso
- Cambio de vestuario: transforma un retrato de origen en una escena con gabardina color camel para un concepto de campaña.
- Cambio de ubicación: lleva un sujeto existente a una calle lluviosa de París e indica qué debe conservarse.
- Corrección localizada de gráficos: marca una zona del cartel con una máscara y pide reemplazar un detalle del fondo.
Guía de prompts y consejos
- Nombra la fuente: comienza con “Image 1 es el retrato que quiero editar” para identificar la base de la instrucción.
- Describe la continuidad: añade “conserva la apariencia de la persona” antes de describir otro vestuario o entorno.
- Asigna funciones a las referencias: escribe “usa la paleta de colores de Image 2” cuando añadas otra entrada.
- Describe el reemplazo de la zona marcada: prueba con “cambia la pared marcada por pintura verde azulada” y una máscara PNG del tamaño correspondiente.
- Precisa el nuevo entorno: usa “calle lluviosa de París a la hora azul” para definir a la vez el lugar y la iluminación.
- 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/edit",
"input": {
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"resolution": "1k"
}
}'
# 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.
