API изображений
Картинки запрашиваются на POST https://api.lowrouter.ru/v1/images/generations. Алиас с тем же телом: POST https://api.lowrouter.ru/v1/images.
Редактирование с файлом — POST https://api.lowrouter.ru/v1/images/edits. PNG-маска есть у GPT Image 1.5. У GPT Image 2 и 2.5 маску не передают — правку описывают в prompt.
Ключ передаётся заголовком Authorization: Bearer sk-lr-…. Нужен API-ключ с правом API.
Ответ всегда приходит сразу в data[] (b64_json и/или url). Опроса статуса нет.
Для gpt-image-2, gpt-image-2.5-flare и gpt-image-2.5-sunburst размер уходит как size в формате ШxВ. Если передать resolution и aspect_ratio без size (или size: auto), шлюз сам подставит ШxВ того же tier. Для 2K/4K и высокого quality таймаут HTTP-клиента — не меньше 180 с.
Что обязательно в каждом запросе
| Поле | Тип | Описание |
|---|---|---|
model |
string | ID модели. Список ниже |
prompt |
string | Что нарисовать или как изменить картинку |
Остальные поля разные у каждой модели. Не копируйте пример одной модели в другую: лишнее поле вернёт ошибку 400.
Параметры размера
Один и тот же эндпоинт, но два контракта:
| Модели | Поля размера |
|---|---|
nano-banana, nano-banana-2, nano-banana-pro |
resolution (512, 1K, 2K, 4K — что поддерживает модель) и aspect_ratio |
gpt-image-1.5, gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst |
size (ШxВ). У 2 и 2.5 можно вместо этого передать resolution + aspect_ratio: шлюз переведёт их в ШxВ |
У nano-banana-pro размер тоже задаётся resolution + aspect_ratio, а не size вида 1024x1024. Подробности — на странице каждой модели ниже.
Поле n (несколько картинок за запрос) есть у GPT Image и grok-imagine-image; у Nano Banana, nano-banana-2 и nano-banana-pro его не передавайте.
Как передать исходную картинку
В image_input можно положить референсы. Для совместимости также принимаются input_references, inputImages и input_images.
- HTTPS-ссылку на файл;
- data URL
data:image/png;base64,…; - голый base64;
- ID файла
file-…изPOST /v1/files.
Форматы: PNG, JPEG, WebP, GIF. Один файл — до 24 МБ, всё тело запроса — до 120 МБ. На запрос — не больше 20 картинок; у части моделей лимит ниже, он указан на странице модели.
Ответ
{
"created": 1710000000,
"data": [
{
"b64_json": "…",
"url": "https://…",
"media_type": "image/png",
"revised_prompt": "…"
}
]
}
В элементе data есть b64_json или url. media_type — фактический MIME (image/png, image/jpeg, image/webp).
Оплата
| Модель | Как списывается |
|---|---|
nano-banana |
за каждое изображение в ответе |
grok-imagine-image |
за каждое изображение в ответе |
sparkpix-image, sparkpix-image-edit |
за каждое изображение в ответе |
gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst |
за каждое изображение в data[]; тариф разрешение × quality (у 2.5 tier по числу пикселей кадра) |
nano-banana-2, nano-banana-pro, gpt-image-1.5 |
один раз за успешный запрос |
Цена зависит от модели, разрешения, quality и (где применимо) числа референсов. Суммы — в каталоге.
Страницы моделей
- Nano Banana —
nano-banana - Nano Banana 2 —
nano-banana-2 - Nano Banana Pro —
nano-banana-pro - GPT Image 1.5 —
gpt-image-1.5 - GPT Image 2 —
gpt-image-2(sync, resolution × quality) - GPT Image 2.5 Flare —
gpt-image-2.5-flare - GPT Image 2.5 Sunburst —
gpt-image-2.5-sunburst - Grok Imagine Image —
grok-imagine-image - Sparkpix Image —
sparkpix-image - Sparkpix Image Edit —
sparkpix-image-edit