Editar imágenes
De imagen a imagen con la API de Cheapest Imagen. Envía imágenes de referencia a /v1/images/edits con GPT Image o Nano Banana, como archivos o enlaces.
Envía un prompt y una o varias imágenes de referencia a POST /v1/images/edits. Todos los modelos aceptan imágenes de referencia, y una edición cuesta los mismos créditos que una imagen nueva.
Sube archivos
Envía la solicitud como formulario. Repite image[] por cada imagen de referencia.
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-F model=nano-banana-2.1 \
-F prompt="put the product on a marble table, soft daylight" \
-F "image[]=@product-front.png" \
-F "image[]=@product-side.png" \
-F size=2048x2048 \
-F response_format=urlCon el SDK de OpenAI:
from openai import OpenAI
client = OpenAI(base_url="https://api.cheapestimagen.com/v1", api_key="YOUR_KEY")
result = client.images.edit(
model="gpt-image-2.6",
image=[open("portrait.png", "rb")],
prompt="change the jacket to dark green, keep the face and the background",
response_format="url",
)
print(result.data[0].url)Envía enlaces en lugar de archivos
Envía JSON con un array images. Cada elemento tiene una image_url, que es un enlace https: o una URL data: en base64.
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-pro",
"prompt": "turn this sketch into a watercolour illustration",
"images": [{ "image_url": "https://example.com/sketch.png" }]
}'file_id no se admite; pasa image_url.
Límites
| Imágenes de referencia por solicitud | De 1 a 16 |
| Tamaño de una imagen | hasta 20 MB |
| Tamaño de toda la solicitud | hasta 50 MB |
| Tipos de archivo | PNG, JPEG, WebP |
Una solicitud que supera estos límites devuelve 413.
Opciones
Todas las opciones de texto a imagen funcionan en las ediciones: n, size, quality, output_format, response_format. Hay una más solo para ediciones:
| Campo | Qué hace | Valores |
|---|---|---|
input_fidelity | Con qué fidelidad conserva el resultado los detalles de las imágenes de referencia | low (por defecto), high. Funciona en GPT Image 2.5 y 2.6 y sus versiones flare y sunburst; los demás modelos devuelven 400 |
Qué no se admite
- Máscaras. No puedes repintar solo una zona. Describe en el prompt lo que debe seguir igual.
- Fondos transparentes.
background: transparentdevuelve400en todos los modelos.
Consejos
- Envía más de un ángulo del sujeto cuando deba seguir igual.
- Di qué no debe cambiar: «mantén la etiqueta sin cambios», «la misma cara y el mismo peinado».
- Para una salida en 2K y 4K usa Nano Banana,
gpt-image-2-adobeo una versión flare o sunburst. Consulta Proporciones y tamaños.
Modelos
Todos los ids de modelo de la API de Cheapest Imagen con el modelo oficial de OpenAI o Google que ejecutan, las resoluciones que crean y sus créditos por imagen.
Proporciones y tamaños
Los tamaños de imagen que puedes pasar en el campo size de la API de Cheapest Imagen: hasta 19 proporciones en 1K, 2K y 4K, y tamaños personalizados.