Introducción
GPT Image 2.5 Flare Edición de imagen ejecuta el gpt-image-2.5-flare de OpenAI sobre imágenes que ya tienes. Acepta de una a dieciséis imágenes de origen, una máscara PNG y la opción de fondo transparente, y devuelve ediciones lo bastante rápido para uso interactivo.
Elige el modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| un brief escrito | GPT Image 2.5 Flare Texto a imagen |
| una imagen que quieres cambiar | GPT Image 2.5 Flare Edición de imagen |
Funciones y aspectos destacados
Composiciones rápidas con varias imágenes
Dos o más imágenes de origen se vuelven una escena, con los rostros conservados de sus propias imágenes. Nuestro ejemplo con dos imágenes terminó en bastante menos de un minuto.
Máscaras y recortes
Una máscara PNG limita el repintado a una zona; background transparent devuelve un canal alfa real en PNG o WebP, listo para un diseño sin paso de keying.
Varios cambios en una pasada
El vestuario, la hora del día y el clima pueden cambiar juntos, siempre que el prompt también diga qué debe quedarse igual. Nuestro ejemplo de la terraza cambió el vestido y la luz en una solicitud.
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
Pruebas de vestuario y cambios de estilo
Muestra a la misma persona con otro atuendo o en otro lugar para un lookbook o un borrador de campaña, con varias opciones por solicitud.
Juntar personas de tomas separadas
Coloca en un mismo cuadro a dos personas fotografiadas por separado, para un póster, una miniatura o un panel de historia.
Renovaciones de temporada
Convierte una imagen de campaña de verano en una versión de otoño o de noche para la siguiente temporada, con la persona y el producto sin cambios.
Guía de prompts y consejos prácticos
Dale una tarea a cada imagen
El hombre y la entrada de la primera imagen, la mujer de la segunda: escríbelo, porque el orden es el único vínculo entre el prompt y las imágenes de origen.
Agrupa cambios relacionados
Un vestido nuevo y otra hora del día se expresan bien en una solicitud; los cambios sin relación funcionan mejor como ediciones separadas.
Sube la fidelidad para los rostros
Pon input_fidelity en high cuando un rostro deba seguir siendo reconocible tras la edición; no cambia el precio.
Usa máscara para cambiar el fondo
Cuando solo deba cambiar el fondo, deja el sujeto opaco y el fondo transparente en una máscara PNG del tamaño de la primera imagen de origen.
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-flare/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.





