Что нового

Образцы: только PNG, JPEG и WebP

Файлы GIF и BMP больше не принимаются ни при загрузке через POST /uploads, ни по ссылке в image_urls. Такой запрос получает 400 ERR_INVALID_REQUEST с текстом «Unsupported image format. Supported formats: PNG, JPEG, WebP.» до списания.

• Формат определяется по содержимому файла, а не по расширению.
• ICO не принимается с 1 октября.
• Файлы, которые вы загрузили раньше, это не затрагивает.

Убрали методы увеличения и удаления фона

Методы POST /images/upscale и POST /images/remove-background больше не существуют: запросы к ним получают 404, как к любому неизвестному адресу.

Nano Banana 2.1 в API

Новейшая модель Google из линейки Nano Banana: реалистичная картинка, точное следование промпту, стабильные персонажи и чёткий текст.

• Разрешения 1K, 2K и 4K. Если разрешение не указано, будет 2K.
• Пятнадцать значений aspect_ratio: десять обычных форматов, вытянутые 1:4, 4:1, 1:8 и 8:1 и auto.
• До 14 образцов в одном запросе.

Пустой промпт отклоняется до списания

Запрос на генерацию без промпта (поле отсутствует, null, пустая строка или одни пробелы) получает 400 ERR_INVALID_REQUEST. Какое поле не заполнено, видно в details.fields. Деньги за такой запрос не списываются.

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

Статусы 422 и 500 для двух кодов ошибок

Два кода ошибок получили собственные HTTP-статусы. Ни один код ошибки API не отвечает статусами 502 и 504.

• 422 ERR_INPUT_FETCH_FAILED — образец не удалось скачать или проверить. Запрос не списан.
• 500 ERR_GENERATION_FAILED — генерацию не удалось запустить или завершить. Списанная сумма возвращается сама.

GPT Image 2.5 Sunburst и Flare в 1K, 2K и 4K

Две модели линейки GPT Image 2.5 для картинок в высоком разрешении. Обе работают в 1K, 2K и 4K и поддерживают восемь соотношений сторон.

• Модель выбирается в поле model, разрешение — в поле resolution. Если разрешение не указано, будет 1K.
• Sunburst отличается точной работой с деталями.

Поле failure в неудачных заданиях

У неудачного задания рядом с текстом error появился объект failure: в ответе на опрос задания и в вебхуке creation.failed. По нему видно, отклонён ли запрос (declined) или случился сбой (error), и стоит ли повторять (retryable).

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