Introducción
GPT Image 2.5 Sunburst Edición de imagen ejecuta el gpt-image-2.5-sunburst de OpenAI sobre imágenes que ya tienes. Acepta de una a dieciséis imágenes de origen, una máscara PNG opcional y la opción de fondo transparente, y es el modelo que OpenAI recomienda cuando la precisión al editar es lo más importante.
Elige el modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| un brief escrito | GPT Image 2.5 Sunburst Texto a imagen |
| una imagen que quieres cambiar | GPT Image 2.5 Sunburst Edición de imagen |
Funciones y aspectos destacados
Máscaras, fidelidad y transparencia
Una máscara limita el repintado a sus píxeles transparentes; input_fidelity high mantiene rostros y telas más cerca de las imágenes de origen; background transparent devuelve un canal alfa real en PNG o WebP.
Hasta dieciséis imágenes de origen
Combina personas, escenarios y productos de hasta dieciséis imágenes en una solicitud, cada una mencionada por su orden en el prompt. Cada imagen de origen suma un cargo fijo de entrada a cada imagen de salida, así que incluye solo las referencias que importan.
La precisión es el objetivo
En nuestra edición del vestido carmesí solo cambió la tela: las mangas de encaje, el rostro, la silla y la única luz principal quedaron donde estaban.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5.000 caracteres. Pon entre comillas dobles cada palabra que deba aparecer en la imagen e indica dónde va; el resto se lee como descripción. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | De 1 a 16 imágenes de origen. Menciónalas en el prompt por su orden (la primera imagen, la segunda imagen). mínimo 1 elementos · máximo 16 elementos |
mask_url | No | PNG opcional del mismo tamaño que la primera imagen de origen. Los píxeles transparentes marcan la zona que se vuelve a pintar; los opacos se conservan. |
aspect_ratio | No | Quince formatos de 1:3 a 3:1, 1:1 de forma predeterminada. El resultado toma el formato que elijas, no el de la imagen de origen, y el formato cambia el precio. |
resolution | No | 1k (predeterminado), 2k o 4k. Una imagen cuadrada mide 1024, 2048 o 2880 píxeles de lado; un nivel mayor cuesta más por imagen. |
quality | No | low, medium, high (predeterminado), xhigh o max. Cada nivel suma detalle, tiempo y costo; reserva xhigh y max para las versiones finales. |
num_outputs | No | De 1 a 10 imágenes por solicitud, 1 de forma predeterminada. Cada imagen se cobra por separado. |
input_fidelity | No | low (predeterminado) o high. High conserva con más fidelidad rostros, telas y detalles impresos de las imágenes de origen. |
background | No | auto (predeterminado), transparent u opaque. Transparent requiere salida png o webp y devuelve un canal alfa real. |
output_format | No | png (predeterminado), jpeg o webp. No cambia el precio. |
output_quality | No | Calidad de compresión para jpeg y webp, de 0 a 100: un valor más alto conserva más detalle y genera archivos más grandes. No se usa con png y no cambia el precio. |
official_fallback | No | Activado de forma predeterminada. Valor predeterminado: |
Precios
Se cobra por imagen de salida según la calidad, el nivel de tamaño y la relación de aspecto; en la ruta oficial, cada imagen de origen suma además un cargo fijo por cada salida. La cotización muestra el total antes de enviar. Una solicitud de una sola edición PNG en calidad high y tamaño 1k, en formato 1:1, 3:2, 2:3, 4:3, 3:4, 16:9 o 9:16, sin máscara, con input fidelity low y background auto empieza en la ruta económica al precio económico. Con Official fallback activado (predeterminado), una solicitud que esa ruta rechace o no pueda completar vuelve a ejecutarse en la ruta oficial al precio oficial, por eso la cotización muestra el precio inicial y el máximo que puede costar. Las solicitudes rechazadas no se cobran. En la ruta oficial, los prompts largos suman un pequeño cargo por los tokens de entrada que pasen de los primeros 100, una vez por solicitud; el texto en chino, japonés o coreano cuenta aproximadamente un token por carácter.
| Especificación | Precio |
|---|---|
| $0.001816 / imagen |
| $0.001816 / imagen |
| $0.00244 / imagen |
| $0.00244 / imagen |
| $0.002752 / imagen |
| $0.002752 / imagen |
| $0.00304 / imagen |
| $0.00304 / imagen |
| $0.003568 / imagen |
| $0.003568 / imagen |
| $0.003808 / imagen |
| $0.003808 / imagen |
| $0.003856 / imagen |
| $0.003856 / imagen |
| $0.004192 / imagen |
| $0.004192 / imagen |
| $0.004744 / imagen |
| $0.004744 / imagen |
| $0.005104 / imagen |
| $0.00568 / imagen |
| $0.00568 / imagen |
| $0.00652 / imagen |
| $0.00652 / imagen |
| $0.007312 / imagen |
| $0.007312 / imagen |
| $0.008176 / imagen |
| $0.008176 / imagen |
| $0.008728 / imagen |
| $0.008728 / imagen |
| $0.010936 / imagen |
| $0.01396 / imagen |
| $0.01396 / imagen |
| $0.018592 / imagen |
| $0.018592 / imagen |
| $0.020998 / imagen (Con Official fallback: hasta $0.023992) |
| $0.020998 / imagen (Con Official fallback: hasta $0.023992) |
| $0.021472 / imagen |
| $0.021472 / imagen |
| $0.022 / imagen (Con Official fallback: hasta $0.028) |
| $0.022 / imagen (Con Official fallback: hasta $0.028) |
| $0.022864 / imagen (Con Official fallback: hasta $0.031456) |
| $0.022864 / imagen (Con Official fallback: hasta $0.031456) |
| $0.024136 / imagen |
| $0.024136 / imagen |
| $0.025636 / imagen (Con Official fallback: hasta $0.042544) |
| $0.0316 / imagen |
| $0.0316 / imagen |
| $0.034504 / imagen |
| $0.034504 / imagen |
| $0.037864 / imagen |
| $0.037864 / imagen |
| $0.043504 / imagen |
| $0.043504 / imagen |
| $0.049816 / imagen |
| $0.049816 / imagen |
| $0.054616 / imagen |
| $0.054616 / imagen |
| $0.055624 / imagen |
| $0.055624 / imagen |
| $0.059872 / imagen |
| $0.059872 / imagen |
| $0.07144 / imagen |
| $0.07144 / imagen |
| $0.075328 / imagen |
| $0.082936 / imagen |
| $0.082936 / imagen |
| $0.096472 / imagen |
| $0.096472 / imagen |
| $0.110728 / imagen |
| $0.110728 / imagen |
| $0.124624 / imagen |
| $0.124624 / imagen |
| $0.135064 / imagen |
| $0.135064 / imagen |
| $0.168976 / imagen |
| $0.002872 / imagen |
| $0.002872 / imagen |
| $0.004456 / imagen |
| $0.004456 / imagen |
| $0.005152 / imagen |
| $0.005152 / imagen |
| $0.005704 / imagen |
| $0.005704 / imagen |
| $0.006328 / imagen |
| $0.006328 / imagen |
| $0.006712 / imagen |
| $0.006712 / imagen |
| $0.007312 / imagen |
| $0.007312 / imagen |
| $0.008128 / imagen |
| $0.008128 / imagen |
| $0.009088 / imagen |
| $0.009088 / imagen |
| $0.009928 / imagen |
| $0.01108 / imagen |
| $0.01108 / imagen |
| $0.01276 / imagen |
| $0.01276 / imagen |
| $0.014176 / imagen |
| $0.014176 / imagen |
| $0.015904 / imagen |
| $0.015904 / imagen |
| $0.017296 / imagen |
| $0.017296 / imagen |
| $0.021808 / imagen |
| $0.024112 / imagen |
| $0.024112 / imagen |
| $0.03688 / imagen |
| $0.03688 / imagen |
| $0.041896 / imagen |
| $0.041896 / imagen |
| $0.043072 / imagen |
| $0.043072 / imagen |
| $0.048064 / imagen |
| $0.048064 / imagen |
| $0.055432 / imagen |
| $0.055432 / imagen |
| $0.062416 / imagen |
| $0.062416 / imagen |
| $0.062944 / imagen |
| $0.062944 / imagen |
| $0.067984 / imagen |
| $0.067984 / imagen |
| $0.07624 / imagen |
| $0.07624 / imagen |
| $0.086032 / imagen |
| $0.087496 / imagen |
| $0.087496 / imagen |
| $0.095248 / imagen |
| $0.095248 / imagen |
| $0.098968 / imagen |
| $0.098968 / imagen |
| $0.110656 / imagen |
| $0.110656 / imagen |
| $0.121312 / imagen |
| $0.121312 / imagen |
| $0.142816 / imagen |
| $0.142816 / imagen |
| $0.152632 / imagen |
| $0.171016 / imagen |
| $0.171016 / imagen |
| $0.19456 / imagen |
| $0.19456 / imagen |
| $0.220456 / imagen |
| $0.220456 / imagen |
| $0.248464 / imagen |
| $0.248464 / imagen |
| $0.274216 / imagen |
| $0.274216 / imagen |
| $0.342928 / imagen |
| $0.003736 / imagen |
| $0.003736 / imagen |
| $0.006016 / imagen |
| $0.006016 / imagen |
| $0.0076 / imagen |
| $0.0076 / imagen |
| $0.008368 / imagen |
| $0.008368 / imagen |
| $0.009304 / imagen |
| $0.009304 / imagen |
| $0.011176 / imagen |
| $0.011176 / imagen |
| $0.01192 / imagen |
| $0.01192 / imagen |
| $0.0124 / imagen |
| $0.0124 / imagen |
| $0.01324 / imagen |
| $0.01324 / imagen |
| $0.016216 / imagen |
| $0.0166 / imagen |
| $0.0166 / imagen |
| $0.02116 / imagen |
| $0.02116 / imagen |
| $0.023872 / imagen |
| $0.023872 / imagen |
| $0.026296 / imagen |
| $0.026296 / imagen |
| $0.028552 / imagen |
| $0.028552 / imagen |
| $0.032272 / imagen |
| $0.032272 / imagen |
| $0.035992 / imagen |
| $0.050776 / imagen |
| $0.050776 / imagen |
| $0.056176 / imagen |
| $0.056176 / imagen |
| $0.0652 / imagen |
| $0.0652 / imagen |
| $0.080464 / imagen |
| $0.080464 / imagen |
| $0.086752 / imagen |
| $0.086752 / imagen |
| $0.094288 / imagen |
| $0.094288 / imagen |
| $0.103984 / imagen |
| $0.103984 / imagen |
| $0.11296 / imagen |
| $0.11296 / imagen |
| $0.115576 / imagen |
| $0.115576 / imagen |
| $0.127864 / imagen |
| $0.127864 / imagen |
| $0.14272 / imagen |
| $0.14272 / imagen |
| $0.14272 / imagen |
| $0.168592 / imagen |
| $0.168592 / imagen |
| $0.184552 / imagen |
| $0.184552 / imagen |
| $0.197104 / imagen |
| $0.197104 / imagen |
| $0.201832 / imagen |
| $0.201832 / imagen |
| $0.253408 / imagen |
| $0.259552 / imagen |
| $0.259552 / imagen |
| $0.320608 / imagen |
| $0.320608 / imagen |
| $0.37588 / imagen |
| $0.37588 / imagen |
| $0.414736 / imagen |
| $0.414736 / imagen |
| $0.456544 / imagen |
| $0.456544 / imagen |
| $0.569656 / imagen |
Casos de uso
Retoca fotos aprobadas
Cambia una prenda, un color o la luz de una foto ya aprobada sin tocar el resto del cuadro, con o sin máscara.
Recortes para diseños
Personas y productos devueltos sobre fondo transparente, listos para un diseño, una diapositiva o una página de producto sin un paso aparte para quitar el fondo.
Nuevos colores de producto
Una misma foto de producto en varios acabados o colores, con máscara sobre el producto para que el set y la luz sigan idénticos.
Guía de prompts y consejos prácticos
Arma la máscara a la medida de la imagen
Mismo tamaño en píxeles que la primera imagen de origen, guardada como PNG y transparente solo donde debe repintarse. Todo lo opaco queda protegido.
Escribe entera la lista de lo protegido
Después del cambio, nombra lo que debe quedarse: rostro, cabello, pose, silla, luz. El modelo sigue una lista escrita con más fiabilidad que una implícita.
En los recortes, di qué se conserva
Indica qué sujeto se queda y que el fondo debe ser totalmente transparente, y pon output_format en png o webp.
Revisa el canal alfa antes de maquetar
Abre el PNG o WebP devuelto en tu herramienta de diseño: la zona vacía es un canal alfa real, así que no hace falta ningún paso extra de keying o máscara.
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.5-sunburst/edit",
"input": {
"aspect_ratio": "1:1",
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"input_fidelity": "low",
"num_outputs": 1,
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.





