Nano Banana 2

ID:google/nano-banana-2

Nano Banana 2 — API генерации изображений от Google. На базе Gemini 3.1 Flash с выводом до 4K, 15 соотношениями сторон и консистентностью до 5 персонажей.

Текст в изображениеРедактирование изображенийРеференсные изображения4KРендеринг текста

Обзор

Аутентификация

Все API-запросы требуют валидный API-ключ, переданный в заголовке Authorization по схеме Bearer.

Быстрый старт

Учётные данные

Задайте переменную окружения RUNBASE_API_KEY.

Shell

export RUNBASE_API_KEY=your-api-key

Создать запуск

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

Запуски

Запуски обрабатываются асинхронно. Отправьте запрос, затем опрашивайте статус для получения результата.

Создать запуск

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

Получить статус запуска

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Получить результат

Опрашивайте эндпоинт статуса, пока status не станет "succeeded", затем прочитайте output.urls из ответа.

Схема входных данных

Параметр	Тип	Обязательный	Описание
prompt	string	Обязательный	Prompt
aspect_ratio	string	Необязательный	Aspect ratioПараметры: `1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9auto`
resolution	string	Необязательный	ResolutionПараметры: `1K2K4K`
image_urls	string[]	Необязательный	Reference images

Схема выходных данных

Поле	Тип	Описание
urls	string[]	URL сгенерированных результатов

Ошибки

API использует стандартные HTTP-коды для индикации успеха или ошибки.

Код статуса	Описание
400	Request không hợp lệ - thiếu hoặc sai định dạng tham số
401	Xác thực thất bại - thiếu hoặc sai khóa API
402	Không đủ tín dụng
403	Bị từ chối - IP không được phép hoặc khóa API vượt giới hạn chi tiêu
404	Không tìm thấy lượt chạy
429	Vượt giới hạn tốc độ
500	Lỗi máy chủ nội bộ