Saltar al contenido
Cheapest Imagen
Guías

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=url

Con 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 solicitudDe 1 a 16
Tamaño de una imagenhasta 20 MB
Tamaño de toda la solicitudhasta 50 MB
Tipos de archivoPNG, 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:

CampoQué haceValores
input_fidelityCon qué fidelidad conserva el resultado los detalles de las imágenes de referencialow (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: transparent devuelve 400 en 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-adobe o una versión flare o sunburst. Consulta Proporciones y tamaños.

En esta página