API

Nano Banana 2 Lite API

Изображение

Nano Banana 2 Lite API обеспечивает быструю и эффективную генерацию изображений с надёжной консистентностью персонажей, плавным объединением нескольких изображений и редактированием на естественном языке для повседневных креативных задач. Интегрируйте Nano Banana 2 Lite API для лёгкой и качественной визуальной генерации.

Авторизация

Bearerstringheaderобязательно

API-ключ для авторизации запросов

Тело

application/json

modelstringобязательно

nano-banana-2-lite

input.promptstringобязательно

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

Максимальная длина: 5 000 символов

input.imagesstring[]необязательно

Необязательные URL референсных изображений. Используйте только общедоступные HTTPS URL. Для генерации изображений по тексту поле можно не передавать.

Максимум элементов: 14

input.aspect_ratiostringнеобязательно

Соотношение ширины и высоты результата. Auto позволяет модели выбрать значение автоматически.

По умолчанию: auto

auto1:12:33:23:44:34:55:49:1616:921:91:44:11:88:1

Примеры запросов

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2-lite",
  "input": {
    "prompt": "Кинематографичная продуктовая фотография футуристической камеры в форме банана"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "nano-banana-2-lite",
    "status": "processing",
    "credits": 18
  }
}

Опрашивайте этот endpoint с возвращённым ID задачи до её завершения или ошибки. Рекомендуем выполнять polling каждые 5 секунд для получения актуального статуса.

POST /api/v1/check

{
  "task_id": "task_example"
}

Ответ

Статус задачи, возвращаемый POST /api/v1/check. ID, URL и временные метки ниже приведены для примера.

idstringобязательно

Идентификатор задачи в data.id совпадает с task_id в запросе проверки.

statusstringобязательно

completed означает успешную генерацию, а data.data содержит результаты. При других статусах data.data равно null.

failed_reasonstringнеобязательно

Возвращается только при status failed и объясняет причину ошибки. Для completed и processing это поле отсутствует.

Завершено · completed

Ссылки для скачивания находятся в data.data.results.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "nano-banana-2-lite",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

Другие статусы

При processing или failed значение data.data равно null. Этот пример показывает failed: только failed содержит failed_reason. При processing продолжайте проверку, при failed прекратите её.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "nano-banana-2-lite",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

Расход кредитов

Расход кредитов на запрос, создающий одно изображение.

Расход кредитов на запрос, создающий одно изображение.
Генерация	Кредиты за запрос
Одно изображение	18

Явно укажите перечисленные параметры input, чтобы использовать соответствующий тариф. Запросы на несколько изображений могут расходовать больше кредитов.

Поле credits в ответе POST /api/v1/create показывает число кредитов, списанных за задачу.