API изображений
Картинки запрашиваются на POST https://api.lowrouter.ru/v1/images/generations. Алиас с тем же телом: POST https://api.lowrouter.ru/v1/images.
Редактирование с файлом и маской — POST https://api.lowrouter.ru/v1/images/edits. Точная маска есть только у GPT Image 1.5 и GPT Image 2.
Ключ передаётся заголовком Authorization: Bearer sk-lr-…. Нужен API-ключ с правом API.
Что обязательно в каждом запросе
| Поле | Тип | Описание |
|---|---|---|
model |
string | ID модели. Список ниже |
prompt |
string | Что нарисовать или как изменить картинку |
Остальные поля разные у каждой модели. Не копируйте пример одной модели в другую: лишнее поле вернёт ошибку 400.
Параметры размера
Один и тот же эндпоинт, но два контракта:
| Модели | Поля размера |
|---|---|
nano-banana, nano-banana-2, nano-banana-pro, aigc-image-kling-3.0 |
resolution (512, 1K, 2K, 4K — что поддерживает модель) и aspect_ratio |
gpt-image-1.5, gpt-image-2 |
size (1024x1024, 1536x1024, 1024x1536, auto; у 2.0 ещё свой ШxВ) |
У nano-banana-pro и Kling тоже resolution + aspect_ratio, а не size вида 1024x1024. Подробности — на странице каждой модели ниже.
Поле n (несколько картинок за запрос) есть у GPT Image; у Nano Banana и Kling его не передавайте (у Kling допустимо только n: 1).
Как передать исходную картинку
В 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 |
за каждое изображение в ответе |
nano-banana-2, nano-banana-pro, gpt-image-1.5, gpt-image-2, aigc-image-kling-3.0 |
один раз за успешный запрос |
Цена зависит от разрешения и числа референсов. Актуальные суммы — в каталоге.
Страницы моделей
- 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 - Kling Image 3.0 —
aigc-image-kling-3.0 - Grok Imagine Image —
grok-imagine-image - Sparkpix Image —
sparkpix-image - Sparkpix Image Edit —
sparkpix-image-edit