Разделы документации
Форматы и размеры изображенийготовится
Планируемый контракт генерации изображений: размеры, качество, форматы ответа и цены
Размеры и качество
Планируется два параметра, которые вместе определяют результат и цену: size — сторона изображения, quality — уровень проработки. Значения передаются в теле запроса POST /v1/images/generations.
| Параметр | Значения | По умолчанию | Что означает |
|---|---|---|---|
| size | 1024x1024, 2048x2048, а также прямоугольные варианты 1024x1536 и 1536x1024 | 1024x1024 | Разрешение готового файла. 1K — быстрый вариант для превью и лент, 2K — для печати и крупных экранов |
| quality | standard, high | standard | standard — базовая проработка, high — больше деталей и стабильнее мелкая графика; время ответа выше |
| n | 1..4 | 1 | Сколько вариантов вернуть за один запрос. Каждый вариант тарифицируется отдельно |
Сочетание size=2048x2048 с quality=standard не планируется: апскейл без высокого качества не даёт выигрыша. Такой запрос вернёт 400 с текстом на русском языке.
Цены
Тарификация поштучная — за каждое возвращённое изображение, независимо от длины подсказки. Изображение, которое вы прикладываете ко входу (редактирование, вариации, разбор картинки), считается отдельно.
| Что тарифицируется | Размер | Качество | Цена за 1 изображение |
|---|---|---|---|
| Генерация | 1024x1024 | standard | 0,54 ₽ |
| Генерация | 1024x1024 | high | 13,50 ₽ |
| Генерация | 2048x2048 | high | 18,90 ₽ |
| Изображение на входе | любой | — | 2,70 ₽ |
Пример: запрос с n=3, size=1024x1024, quality=high стоит 40,50 ₽. Тот же запрос с одним приложенным исходником — 43,20 ₽.
Формат ответа и срок жизни ссылки
Параметр response_format принимает два значения: url (по умолчанию) и b64_json. В первом случае возвращается временная ссылка на файл, во втором — само изображение в base64 внутри JSON. Ответ отдаётся с Content-Type: application/json; charset=utf-8.
Ссылка живёт 60 минут с момента ответа, после чего файл удаляется и запрос по ссылке отдаёт 404. Скачайте изображение сразу или используйте response_format=b64_json, если хранить его нужно дольше. Ссылка одноразовая по смыслу, но не по счётчику: пока она жива, скачивать можно сколько угодно раз, скачивание внутри этого часа не тарифицируется.
Форматы файлов на входе
Для редактирования и вариаций изображение передаётся как multipart/form-data в поле image, маска — в поле mask.
| Требование | Значение |
|---|---|
| Форматы | PNG, JPEG, WebP |
| Максимальный размер файла | 20 МБ |
| Максимальная сторона | 4096 пикселей |
| Маска | только PNG с альфа-каналом, размер строго как у исходника |
| Цветовой профиль | sRGB; остальные профили приводятся к sRGB |
Анимированные GIF, HEIC, TIFF, SVG и PDF не принимаются — ответ 400. Обратите внимание: передача картинок в messages эндпоинта /v1/chat/completions работает иначе и сейчас изображения там молча отбрасываются, разбор картинок в чате не поддерживается.