Introducción
GPT Image 2 Edición de imagen ejecuta el modelo gpt-image-2 de OpenAI sobre imágenes que ya tienes. Dale de una a diez imágenes de origen y una instrucción: cambia una prenda o un color, vuelve a escribir un titular, ilumina de nuevo una escena o combina personas y lugares de varias imágenes en un solo cuadro. Una máscara PNG opcional limita el repintado a una sola zona.
Elige el modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| un brief escrito | GPT Image 2 Texto a imagen |
| una imagen que quieres cambiar | GPT Image 2 Edición de imagen |
Funciones y aspectos destacados
Edición por instrucciones, con máscara cuando hace falta
Sin máscara, el modelo deduce del prompt qué cambiar y vuelve a dibujar el resto para que encaje. Con máscara, solo se repintan los píxeles transparentes y todo lo demás se conserva.
Hasta diez imágenes de origen por solicitud
Menciona cada imagen por su orden: la primera aporta la persona, la segunda el escenario, la tercera el producto. El modelo las combina en un cuadro nuevo.
Control de fidelidad y formato
Input_fidelity high mantiene rostros, telas y detalles impresos más cerca de las imágenes de origen. La relación de aspecto auto conserva el formato de la primera imagen; cualquiera de los quince formatos fijos le da esa forma al resultado.
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 10 imágenes de origen. Menciónalas en el prompt por su orden (la primera imagen, la segunda imagen). mínimo 1 elementos · máximo 10 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 | auto (predeterminado) conserva el formato de la primera imagen de origen con cerca de 1,5 megapíxeles e ignora el nivel de tamaño; o elige uno de quince formatos de 1:3 a 3:1. |
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 (predeterminado) o high. |
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) u opaque. OpenAI no ofrece salida transparente en GPT Image 2; para recortes usa GPT Image 2.5 Sunburst o Flare. |
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 medium y tamaño 1k, en cualquier formato salvo 21:9, 9:21, 3:1 y 1:3, 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.002872 / imagen |
| $0.002872 / imagen |
| $0.00304 / imagen |
| $0.00304 / imagen |
| $0.003568 / imagen |
| $0.003568 / imagen |
| $0.003736 / imagen |
| $0.003736 / imagen |
| $0.003856 / imagen |
| $0.003856 / imagen |
| $0.004192 / imagen |
| $0.004192 / imagen |
| $0.004456 / imagen |
| $0.004456 / imagen |
| $0.005104 / imagen |
| $0.005152 / imagen |
| $0.005152 / imagen |
| $0.005704 / imagen |
| $0.005704 / imagen |
| $0.005896 / imagen |
| $0.006016 / imagen |
| $0.006016 / imagen |
| $0.006712 / imagen |
| $0.006712 / imagen |
| $0.007312 / imagen |
| $0.007312 / imagen |
| $0.0076 / imagen |
| $0.0076 / imagen |
| $0.008128 / imagen |
| $0.008128 / imagen |
| $0.009304 / imagen |
| $0.009304 / imagen |
| $0.009928 / imagen |
| $0.009928 / imagen |
| $0.011176 / imagen |
| $0.011176 / imagen |
| $0.01192 / imagen |
| $0.01192 / imagen |
| $0.01324 / imagen |
| $0.01324 / imagen |
| $0.016216 / imagen |
| $0.016216 / imagen |
| $0.01396 / imagen |
| $0.01396 / imagen |
| $0.018592 / imagen |
| $0.018592 / imagen |
| $0.020368 / imagen (Con Official fallback: hasta $0.021472) |
| $0.020368 / imagen (Con Official fallback: hasta $0.021472) |
| $0.020998 / imagen (Con Official fallback: hasta $0.023992) |
| $0.020998 / imagen (Con Official fallback: hasta $0.023992) |
| $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.023626 / imagen (Con Official fallback: hasta $0.034504) |
| $0.023626 / imagen (Con Official fallback: hasta $0.034504) |
| $0.024112 / imagen |
| $0.024112 / imagen |
| $0.025636 / imagen (Con Official fallback: hasta $0.042544) |
| $0.027448 / imagen (Con Official fallback: hasta $0.049792) |
| $0.032272 / imagen |
| $0.032272 / imagen |
| $0.03688 / imagen |
| $0.03688 / imagen |
| $0.043072 / imagen |
| $0.043072 / imagen |
| $0.048064 / imagen |
| $0.048064 / imagen |
| $0.050776 / imagen |
| $0.050776 / imagen |
| $0.055432 / imagen |
| $0.055432 / imagen |
| $0.062416 / imagen |
| $0.062416 / imagen |
| $0.0652 / imagen |
| $0.0652 / imagen |
| $0.067984 / imagen |
| $0.067984 / imagen |
| $0.080464 / imagen |
| $0.080464 / imagen |
| $0.086032 / imagen |
| $0.086032 / imagen |
| $0.094288 / imagen |
| $0.094288 / imagen |
| $0.103984 / imagen |
| $0.103984 / imagen |
| $0.11296 / imagen |
| $0.11296 / imagen |
| $0.14272 / imagen |
| $0.14272 / imagen |
| $0.054616 / imagen |
| $0.054616 / imagen |
| $0.07144 / imagen |
| $0.07144 / imagen |
| $0.082936 / imagen |
| $0.082936 / imagen |
| $0.095248 / imagen |
| $0.095248 / imagen |
| $0.096472 / imagen |
| $0.096472 / imagen |
| $0.110728 / imagen |
| $0.110728 / imagen |
| $0.124624 / imagen |
| $0.124624 / imagen |
| $0.127864 / imagen |
| $0.127864 / imagen |
| $0.135064 / imagen |
| $0.135064 / imagen |
| $0.142816 / imagen |
| $0.142816 / imagen |
| $0.168976 / imagen |
| $0.171016 / imagen |
| $0.171016 / imagen |
| $0.19456 / imagen |
| $0.19456 / imagen |
| $0.197104 / imagen |
| $0.197104 / imagen |
| $0.197968 / imagen |
| $0.220456 / imagen |
| $0.220456 / imagen |
| $0.248464 / imagen |
| $0.248464 / imagen |
| $0.259552 / imagen |
| $0.259552 / imagen |
| $0.274216 / imagen |
| $0.274216 / imagen |
| $0.320608 / imagen |
| $0.320608 / imagen |
| $0.342928 / imagen |
| $0.342928 / imagen |
| $0.37588 / imagen |
| $0.37588 / imagen |
| $0.414736 / imagen |
| $0.414736 / imagen |
| $0.456544 / imagen |
| $0.456544 / imagen |
| $0.569656 / imagen |
| $0.569656 / imagen |
Casos de uso
Rehacer texto y estilo de piezas terminadas
Cambia las palabras de un póster o una portada, el color de un producto o una prenda, y deja la foto de fondo tal como se aprobó.
Escenas compuestas a partir de referencias
Coloca a una persona de una foto en el escenario de otra, o junta a dos personas de tomas distintas, sin reconstruir el diseño desde un prompt de texto.
Versiones localizadas de una misma pieza
Conserva la foto y reemplaza el titular por una línea traducida para cada mercado, una edición por idioma.
Guía de prompts y consejos prácticos
Di qué se queda y qué cambia
Escribe primero el cambio y luego lo que no debe moverse: rostro, pose, luz, fondo, logotipo. Todo lo que no protejas puede volver a dibujarse.
Numera tus imágenes de origen
Escribe "la mujer de la primera imagen" y "el barco de la segunda imagen". El orden en image_urls es la única forma en que el modelo las distingue.
Usa una máscara para arreglos pequeños
Para un solo objeto o un trozo de fondo, una máscara PNG del mismo tamaño que la primera imagen es más fiable que describir la zona con palabras.
Deja auto para conservar el encuadre
Deja la relación de aspecto en auto cuando la edición deba conservar el encuadre de la imagen de origen; elige un formato fijo solo si el resultado necesita otra forma.
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/edit",
"input": {
"aspect_ratio": "auto",
"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.





