К содержимому

Nano Banana API

Эндпоинты и аутентификация

Relay использует формат, совместимый с OpenAI Images API:

  • Генерация изображений: POST https://relay-llm.ru/v1/images/generations
  • Редактирование изображений: POST https://relay-llm.ru/v1/images/edits

Заголовки запроса:

http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Эндпоинт редактирования также принимает multipart/form-data для загрузки файлов изображений.

Генерация изображений

Минимальный запрос:

bash
curl https://relay-llm.ru/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana",
    "prompt": "An orange tabby cat typing on a keyboard, illustration style"
  }'

Укажите размер и качество:

json
{
  "model": "nano-banana",
  "prompt": "An orange tabby cat typing on a keyboard, illustration style",
  "size": "2048x2048",
  "quality": "high"
}

Основные параметры:

ПараметрОписание
modelИспользуйте nano-banana. Модель нужно указывать явно: если model не задан, по умолчанию используется nano-banana.
promptОписание изображения, которое нужно сгенерировать.
sizeauto или ширинаxвысота, например 1024x1024, 2048x2048, 3840x2160.
qualitylow, medium, high или auto.
nЧисло изображений за запрос. По умолчанию 1.
output_formatpng, jpeg или webp.
output_compressionУровень сжатия JPEG/WebP, от 0 до 100.
backgroundtransparent, opaque или auto. При transparent возвращаемое изображение содержит альфа-канал; сочетайте с output_format png или webp.
moderationСтрогость модерации контента, low или auto.
streamtrue , ответ приходит потоком по SSE: у промежуточных фрагментов потока (чанков) object равен image.generation.chunk, у финального , image.generation.result с изображением в data[0].b64_json, затем data: [DONE].
partial_imagesОт 0 до 3. Сейчас промежуточные фрагменты не содержат изображения; результат только в финальном фрагменте.
userИдентификатор конечного пользователя в вашем приложении, передаётся как есть.

Ограничения OpenAI на размер для nano-banana: длинная сторона не более 3840 пикселей; ширина и высота кратны 16; соотношение сторон не более 3:1; общее число пикселей от 655 360 до 8 294 400. Размеры задаются в пикселях, а не фиксированными строками 1k, 2k, 4k.

Редактирование изображений

bash
curl https://relay-llm.ru/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=nano-banana" \
  -F "prompt=Replace the background with snowy mountains" \
  -F "image=@input.png" \
  -F "size=1024x1024"

Основные параметры:

ПараметрОписание
modelИспользуйте nano-banana.
imageФайл исходного изображения.
maskФайл маски; прозрачные области редактируются. Размеры маски должны совпадать с размерами исходного изображения.
promptИнструкция по редактированию.
nЧисло изображений за запрос. По умолчанию 1.
sizeauto или ширинаxвысота.
qualitylow, medium, high или auto.
backgroundtransparent, opaque или auto. По результатам тестов изображения из эндпоинта редактирования не содержат альфа-канала.
input_fidelityНасколько точно сохранять детали исходного изображения, high или low.
output_formatpng, jpeg или webp.
output_compressionУровень сжатия JPEG/WebP, от 0 до 100.
streamtrue , ответ приходит потоком по SSE. Формат событий такой же, как при генерации изображений.
partial_imagesОт 0 до 3.
userИдентификатор конечного пользователя в вашем приложении, передаётся как есть.

Размеры и правила тарификации

Параметры и единица цены зависят от модели. Ниже приведены первые три строки её активного прайса.

Параметры моделиЦена
mode: text-to-image0.1 USD / запрос
mode: edit0.16 USD / запрос

Параметры и цены берутся из каталога модели. Если size равен auto, не указан или пуст, тарификация идёт по размеру, который реально выдала модель; без size модель по умолчанию выдаёт 1024 или 1254 пикселя, что тарифицируется как 1K или 2K соответственно. Если нужна фиксированная ступень, укажите size явно. Цены трёх ступеней смотрите в разделе актуальные цены.

FAQ

Codex сообщает, что сервис генерации изображений недоступен или не удаётся подключиться?

С разрешениями по умолчанию Codex ограничивает доступ к сети, и запрос на генерацию изображения блокируется. Включите полный доступ (Full access) и повторите генерацию.

Нажмите кнопку разрешений в левом нижнем углу поля ввода Codex и выберите полный доступ.

Меню разрешений в левом нижнем углу поля ввода Codex, выбран полный доступ (на скриншоте китайский интерфейс)

Если в этом меню нет пункта полного доступа, нажмите значок шестерёнки в левом нижнем углу окна, откройте «Настройки → Основные → Разрешения» (Settings → General → Permissions), включите полный доступ, а затем выберите его в поле ввода, как описано выше.

Настройки Codex → Основные → Разрешения, полный доступ включён (на скриншоте китайский интерфейс)

В режиме полного доступа Codex не спрашивает подтверждения, прежде чем изменять файлы на компьютере или запускать команды с доступом к сети.

Пополнение баланса

Способы оплаты, валюта и минимальная сумма показаны в форме пополнения баланса Relay.Пополнение баланса.

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key