Saltar al contenido
Cheapest Imagen
Referencia de la API

Editar imagen

Crea imágenes a partir de un prompt y una o varias imágenes de referencia, enviadas como archivos en un formulario multipart o como enlaces.

POST
/images/edits

Crea imágenes a partir de un prompt y una o varias imágenes de referencia, enviadas como archivos en un formulario multipart o como enlaces.

Authorization

apiKey
headerAuthorizationBearer <token>

Tu clave de API, enviada como Authorization: Bearer <key>.

Header Parameters

Idempotency-Key?string

Un valor que tú eliges, de hasta 255 caracteres. Enviar de nuevo el mismo valor no crea ni cobra una segunda solicitud; devuelve 409.

Lengthlength <= 255

Request Body

multipart/form-data
  1. body
model*string

El modelo que se usará.

Value in"gpt-image-2""gpt-image-2-adobe""gpt-image-2.5""gpt-image-2.5-flare""gpt-image-2.5-sunburst""gpt-image-2.6""gpt-image-2.6-flare""gpt-image-2.6-sunburst""nano-banana-2""nano-banana-2.1""nano-banana-pro""nano-banana-2-1k""nano-banana-2-2k""nano-banana-2-4k""nano-banana-pro-1k""nano-banana-pro-2k""nano-banana-pro-4k"
prompt*string

Lo que debe mostrar la imagen. Hasta 32 000 caracteres.

Lengthlength <= 32000
n?integer

Cuántas imágenes crear. Una solicitud gasta n veces los créditos del modelo. Como máximo 10 en 1K, 4 en 2K y 2 en 4K.

Range1 <= value <= 10
Default1
size?string

auto deja que elija el modelo (en un modelo con una sola resolución, esa resolución). Los demás valores son tamaños de 1K, 2K y 4K; cada modelo acepta las resoluciones que indica su ficha en /es/models, a un único precio. Consulta la guía de tamaños para ver la proporción de cada uno. gpt-image-2-adobe y gpt-image-2.5-flare también aceptan un ancho y un alto propios: múltiplos de 16, hasta 3840 px por lado, con una proporción máxima de 3:1, de 655 360 a 8 294 400 píxeles.

Default"auto"
Value in"auto""1024x1024""1536x1024""1024x1536""1443x1090""1090x1443""1672x941""941x1672""1408x1120""1120x1408""1920x832""832x1920""1792x896""896x1792""1152x864""864x1152""1280x720""720x1280""1120x896""896x1120""1456x624""624x1456""1536x768""768x1536""2048x2048""2048x1360""1360x2048""2304x1728""1728x2304""2048x1152""1152x2048""2240x1792""1792x2240""2912x1248""1248x2912""3072x1536""1536x3072""2048x688""688x2048""2880x2880""3504x2336""2336x3504""3264x2448""2448x3264""3840x2160""2160x3840""3200x2560""2560x3200""3840x1648""1648x3840""3840x1920""1920x3840""3840x1280""1280x3840""2048x512""512x2048""3072x384""384x3072""4096x1024""1024x4096""6144x768""768x6144""8192x2048""2048x8192""12288x1536""1536x12288"
quality?string

Calidad de renderizado, respetada por gpt-image-2-adobe y por las variantes flare y sunburst; los demás modelos GPT la eligen ellos mismos y Nano Banana la ignora. xhigh y max solo funcionan en gpt-image-2.5-sunburst. Todas las calidades cuestan lo mismo.

Default"auto"
Value in"auto""low""medium""high""xhigh""max"
background?string

Ningún modelo crea por ahora un fondo transparente, así que transparent devuelve un 400. auto y opaque funcionan en todos los modelos.

Default"auto"
Value in"auto""opaque"
output_format?string

Formato de archivo de las imágenes devueltas. gif funciona en gpt-image-2.6 y en sus variantes flare y sunburst, y svg solo en gpt-image-2.6. png, jpeg y webp funcionan en todos los modelos.

Default"png"
Value in"png""jpeg""webp""gif""svg"
output_compression?integer

Calidad para jpeg y webp, de 0 a 100. Por defecto, 100.

Range0 <= value <= 100
moderation?string

Con qué rigor se revisan el prompt y el resultado. low es menos restrictivo.

Default"auto"
Value in"auto""low"
response_format?string

b64_json devuelve los datos de la imagen en la respuesta. url devuelve un enlace a la imagen, que se conserva 72 horas.

Default"b64_json"
Value in"b64_json""url"
async?boolean

Pon true para ejecutar la solicitud en segundo plano. La respuesta es 202 con una tarea al instante; lee el resultado más tarde con GET /images/tasks/{id}. Las imágenes se devuelven como enlaces, así que response_format debe ser url o omitirse. La cabecera Prefer: respond-async hace lo mismo.

Defaultfalse
webhook_url?string

Con async: una dirección https:// que recibe un POST con la tarea terminada (el mismo JSON que GET /images/tasks/{id}). Se intenta hasta 3 veces. Envía webhook_secret para que la llamada vaya firmada; sin él, confirma lo que recibes consultando la tarea con tu clave.

Formaturi
webhook_secret?string

Con webhook_url: un secreto propio, de 16 a 128 caracteres. La llamada a tu dirección lleva entonces x-webhook-signature: t=<unix seconds>,v1=<hex>, donde el hex es el HMAC-SHA256 de <t>.<body> calculado con este secreto.

Length16 <= length <= 128
image[]*array<>

Imágenes de referencia: PNG, JPEG o WebP, de 1 a 16 archivos, de hasta 20 MB cada uno y 50 MB en total.

Items1 <= items <= 16
input_fidelity?string

Con qué fidelidad conserva el resultado los detalles de las imágenes de referencia. gpt-image-2 no lo acepta.

Value in"low""high"

Response Body

Las imágenes.

application/json
  1. response
created*integer

Cuándo se crearon las imágenes, como marca de tiempo Unix en segundos.

data*array<>
Example Request
curl -X POST 'https://api.cheapestimagen.com/v1/images/edits' \  -F 'model=gpt-image-2' \  -F 'prompt=string' \  -F 'image[]=[  "string"]'
Example Response
{  "created": 0,  "data": [    {      "b64_json": "string",      "url": "http://example.com"    }  ]}