Novedades

Imágenes de referencia: solo PNG, JPEG y WebP

Los archivos GIF y BMP ya no se aceptan ni al subirlos con POST /uploads ni por enlace en image_urls. Una solicitud así recibe 400 ERR_INVALID_REQUEST con el texto «Unsupported image format. Supported formats: PNG, JPEG, WebP.» antes del cargo.

• El formato se determina por el contenido del archivo, no por la extensión.
• ICO no se acepta desde el 1 de octubre.
• Esto no afecta a los archivos que subiste antes.

Se retiraron los endpoints de ampliación y de eliminación de fondo

Los endpoints POST /images/upscale y POST /images/remove-background ya no existen: las solicitudes que se les envían reciben 404, igual que las enviadas a cualquier dirección desconocida.

Nano Banana 2.1 en la API

El modelo más reciente de la línea Nano Banana de Google: imagen realista, seguimiento preciso del prompt, personajes estables y texto nítido.

• Resoluciones 1K, 2K y 4K. Si no indicas la resolución, será 2K.
• Quince valores de aspect_ratio: diez relaciones de aspecto habituales, las alargadas 1:4, 4:1, 1:8 y 8:1, y auto.
• Hasta 14 imágenes de referencia en una sola solicitud.

Un prompt vacío se rechaza antes del cargo

Una solicitud de generación sin prompt (el campo no está, es null, una cadena vacía o solo espacios) recibe 400 ERR_INVALID_REQUEST. En details.fields se ve qué campo no se ha rellenado. No se hace ningún cargo por una solicitud así.

{
  "error": {
    "code": "ERR_INVALID_REQUEST",
    "message": "A prompt is required. Describe the image to generate in the prompt.",
    "details": { "fields": ["prompt"] }
  }
}

Estados 422 y 500 para dos códigos de error

Dos códigos de error recibieron estados HTTP propios. Ningún código de error de la API responde con los estados 502 y 504.

• 422 ERR_INPUT_FETCH_FAILED — no se pudo descargar ni comprobar la imagen de referencia. No se hace ningún cargo.
• 500 ERR_GENERATION_FAILED — no se pudo iniciar ni completar la generación. El importe cargado se devuelve automáticamente.

GPT Image 2.5 Sunburst y Flare en 1K, 2K y 4K

Dos modelos de la línea GPT Image 2.5 para imágenes en alta resolución. Ambos funcionan en 1K, 2K y 4K y admiten ocho relaciones de aspecto.

• El modelo se elige en el campo model y la resolución, en el campo resolution. Si no indicas la resolución, será 1K.
• GPT Image 2.5 Sunburst se distingue por su trabajo preciso con los detalles.

El campo failure en las tareas fallidas

Una tarea fallida ahora incluye, junto al texto error, un objeto failure: en la respuesta a la consulta de estado de la tarea y en el webhook creation.failed. Con él se ve si se rechazó la solicitud (declined) o si hubo un fallo (error), y si conviene reintentar (retryable).

"failure": { "type": "declined", "code": "content_policy", "retryable": false }