Nano Banana 2 Lite Standard

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

• Оплата по токенам: ввод, текстовый вывод с рассуждениями и вывод изображения по тарифам за 1 млн токенов. Цены за изображение ниже — оценка по заявленному числу токенов изображения для каждого resolution.
• Только асинхронно: создайте задачу через POST /v1/images/tasks, затем опрашивайте GET /v1/tasks/{task_id}. Генерация идёт на стороне BeatAPI, поэтому даже долгая генерация не держит ваше соединение. Синхронный POST /v1/images/generations для этой модели недоступен.
• Одна задача создаёт одно изображение. Для нескольких изображений создайте несколько задач.
• Генерация по тексту либо редактирование и объединение до 14 референсных изображений по общедоступным HTTPS-ссылкам.
• Задача, завершившаяся ошибкой, не оплачивается: резерв возвращается полностью.

Открывает модель в API Explorer. Введите свой API-ключ BeatAPI, чтобы создать задачу. Это настоящий запрос: его стоимость спишется с вашего баланса.

Идентификаторы моделей

Модель с фиксированной ценой и эта модель принимают один и тот же запрос; различается только способ расчёта цены. Значения ниже взяты прямо из контракта шлюза.

Адрес API и авторизация

POST https://api.beatapi.io/v1/images/tasks

Передавайте тело запроса в JSON с заголовком Content-Type: application/json. Idempotency-Key необязателен. Для каждого логического запроса используйте уникальное значение длиной не более 255 символов и повторно используйте его только для отправки точно такого же тела. В течение 24 часов повтор с тем же ключом и телом возвращает первый ответ с заголовком Idempotent-Replayed: true. Тот же ключ с другим телом возвращает 409 idempotency_conflict. Ответы, отличные от 2xx, не сохраняются, поэтому повтор после 400 или 402 выполняется заново.

Как выполняется запрос

Режимы ввода

Параметры запроса

"images": [
  "https://cdn.beatapi.io/samples/smart-bottle.png",
  "https://cdn.beatapi.io/samples/neon-singer.png"
]

Перед созданием задачи шлюз также проверяет следующие сочетания параметров:

• Оплата по токенам по прейскурантным тарифам за токены, которые расходует каждая генерация (ввод, текстовый вывод с рассуждениями, вывод изображения); указанные цены за изображение — оценка по заявленному числу токенов изображения для каждого разрешения.
• Это официальная версия с оплатой по токенам; nano-banana-2-lite — та же модель с фиксированной ценой за изображение.

Ограничения входных материалов

До создания задачи шлюз проверяет каждый входной материал. Если ограничение нарушено, возвращается 400 bad_request с указанием материала. Средства не списываются.

• Референсные изображения: PNG, JPEG или WebP, формат определяется по содержимому, а не имени файла или Content-Type. До 50 MB каждый (десятичные мегабайты; проверяется, если сервер сообщает размер), от 1 до 14 ссылок. GIF, HEIC и SVG отклоняются.
• Для этой модели ограничения числа пикселей и соотношения сторон не проверяются.
• Если сервер не ответил вовремя, ссылка не отклоняется при создании. Если скачать её не удастся и позже, задача завершится с bad_request, а средства вернутся.
• Файл находится на вашем устройстве? Загрузите его через POST /v1/files и передайте полученный data.url.

Создать задачу и опрашивать

Эта модель работает только как задача. POST /v1/images/tasks отвечает сразу, идентификатор задачи — в data.id; затем вызывайте GET /v1/tasks/{task_id} каждые data.poll_after_seconds, пока data.status не станет succeeded или failed. Генерация идёт на стороне BeatAPI, поэтому даже долгая генерация не держит ваше соединение и не упирается в тайм-аут клиента. Синхронный POST /v1/images/generations для этой модели недоступен.

# 1. Create the task. The call returns at once; the task ID is in data.id.
TASK_ID=$(curl -sS -X POST https://api.beatapi.io/v1/images/tasks \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"nano-banana-2-lite-std","prompt":"A minimalist product photo of a glass water bottle on wet black stone, soft rim light, shallow depth of field","resolution":"1K"}' | jq -r '.data.id')
# 2. Poll until the task is final. The render runs on BeatAPI, not on this connection.
while true; do
  TASK=$(curl -sS "https://api.beatapi.io/v1/tasks/$TASK_ID" -H "Authorization: Bearer $BEATAPI_API_KEY")
  STATUS=$(echo "$TASK" | jq -r '.data.status')
  if [ "$STATUS" = "succeeded" ] || [ "$STATUS" = "failed" ]; then break; fi
  sleep 5
done
echo "$TASK" | jq '.data.output.media[].url, .data.usage'

Через Capabilities API это та же задача: запустите её через POST /v1/capabilities/run, затем отправляйте запрос статуса с полученным идентификатором задачи, пока не будет succeeded или failed.

{"reference":"model:nano-banana-2-lite-std","input":{"model":"nano-banana-2-lite-std","prompt":"A minimalist product photo of a glass water bottle on wet black stone, soft rim light, shallow depth of field","resolution":"1K"}}

{"reference":"model:nano-banana-2-lite-std","operation":"status","task_id":"<task_id>"}

Оплата по токенам и фиксированная цена

Параметры, которые модель не принимает

API изображений знает несколько полей, используемых другими моделями. Здесь они не игнорируются, а отклоняются, чтобы вы не платили за настройку без эффекта:

• quality, seed, background, size, enhance_prompt → field "quality" is not supported by model nano-banana-2-lite-std (с именем переданного поля).
• Любое другое неизвестное поле, например n → unknown field: n. Поля n нет: одна задача создаёт одно изображение.

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

curl --request POST \
  --url https://api.beatapi.io/v1/images/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "nano-banana-2-lite-std",
  "prompt": "A minimalist product photo of a glass water bottle on wet black stone, soft rim light, shallow depth of field",
  "aspect_ratio": "16:9",
  "resolution": "1K"
}'

Изображение по тексту

Горизонтальное изображение в 1K по промпту.

curl --request POST \
  --url https://api.beatapi.io/v1/images/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "nano-banana-2-lite-std",
  "prompt": "A minimalist product photo of a glass water bottle on wet black stone, soft rim light, shallow depth of field",
  "aspect_ratio": "16:9",
  "resolution": "1K"
}'

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

Изменение фона с сохранением товара. auto обычно сохраняет пропорции референса.

curl --request POST \
  --url https://api.beatapi.io/v1/images/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "nano-banana-2-lite-std",
  "prompt": "Keep the bottle exactly as it is. Replace the background with a sunlit kitchen counter and add a soft reflection under the bottle.",
  "images": [
    "https://cdn.beatapi.io/samples/smart-bottle.png"
  ],
  "aspect_ratio": "auto"
}'

Объединение нескольких изображений

Укажите каждый референс в промпте по его порядку.

curl --request POST \
  --url https://api.beatapi.io/v1/images/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "nano-banana-2-lite-std",
  "prompt": "Place the bottle from the first image on a neon-lit stage like the one in the second image. Keep the bottle label readable.",
  "images": [
    "https://cdn.beatapi.io/samples/smart-bottle.png",
    "https://cdn.beatapi.io/samples/neon-singer.png"
  ],
  "aspect_ratio": "1:1",
  "resolution": "1K"
}'

Постер JPEG в 1K

Вертикальный постер в формате JPEG.

curl --request POST \
  --url https://api.beatapi.io/v1/images/tasks \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "nano-banana-2-lite-std",
  "prompt": "A retro travel poster of a coastal city at sunset, bold flat colours, large title text \"SEASIDE\" at the top",
  "aspect_ratio": "9:16",
  "resolution": "1K",
  "output_format": "jpeg"
}'

Ответы

Создание задачи (201)

Объект задачи. Поле output равно null, пока задача не завершится успешно. Поля с пометкой «во время выполнения» исчезают после завершения задачи.

{
  "data": {
    "id": "task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ",
    "object": "task",
    "task_kind": "image",
    "capability_id": "nano-banana-2-lite-std",
    "capability_version": 1,
    "media_type": "image",
    "model": "nano-banana-2-lite-std",
    "status": "queued",
    "stage": "queued",
    "created_at": 1791993600,
    "updated_at": 1791993600,
    "completed_at": null,
    "poll_after_seconds": 5,
    "output": null,
    "usage": {
      "credits_reserved": 0.01848,
      "credits_settled": 0,
      "credits_refunded": 0,
      "credits_charged": 0.01848
    },
    "request_id": "req_5f0c2a9e4b7d4e31",
    "error_code": null,
    "error_message": null
  }
}

Успешно завершённая задача

GET /v1/tasks/{task_id} возвращает HTTP 200 со status: "succeeded" и результатом в data.output.

{
  "data": {
    "id": "task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ",
    "object": "task",
    "task_kind": "image",
    "capability_id": "nano-banana-2-lite-std",
    "capability_version": 1,
    "media_type": "image",
    "model": "nano-banana-2-lite-std",
    "status": "succeeded",
    "stage": "succeeded",
    "created_at": 1791993600,
    "updated_at": 1791993690,
    "completed_at": 1791993690,
    "output": {
      "media": [
        {
          "type": "image",
          "url": "https://media.beatapi.io/outputs/task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ/0.png",
          "mime_type": "image/png"
        }
      ],
      "r2_url": "https://media.beatapi.io/outputs/task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ/0.png"
    },
    "usage": {
      "credits_reserved": 0.01848,
      "credits_settled": 0.01848,
      "credits_refunded": 0,
      "credits_charged": 0.01848
    },
    "request_id": "req_5f0c2a9e4b7d4e31",
    "error_code": null,
    "error_message": null
  }
}

Поля результата

Задача, завершившаяся ошибкой

Если задача завершилась ошибкой, GET /v1/tasks/{task_id} всё равно возвращает HTTP 200: сведения об ошибке находятся в теле ответа. Зарезервированная сумма возвращается полностью, поэтому списания нет.

{
  "data": {
    "id": "task_7Qm2Xc9LpR4vT8sKa1Nf6YbH3eWdJ0uZ",
    "object": "task",
    "task_kind": "image",
    "capability_id": "nano-banana-2-lite-std",
    "capability_version": 1,
    "media_type": "image",
    "model": "nano-banana-2-lite-std",
    "status": "failed",
    "stage": "failed",
    "created_at": 1791993600,
    "updated_at": 1791993690,
    "completed_at": 1791993690,
    "output": null,
    "usage": {
      "credits_reserved": 0.01848,
      "credits_settled": 0,
      "credits_refunded": 0.01848,
      "credits_charged": 0
    },
    "retryable": true,
    "request_id": "req_5f0c2a9e4b7d4e31",
    "error_code": "processing_failed",
    "error_message": "The task failed during processing on our side. Retry; a failed task is refunded."
  }
}

Полный пример

Создайте задачу, дождитесь её завершения с интервалом опроса, указанным сервером, и выведите ссылки на результаты. Задайте BEATAPI_API_KEY в переменной окружения и установите requests.

import os
import time
import uuid
import requests
API = "https://api.beatapi.io"
HEADERS = {"Authorization": f"Bearer {os.environ['BEATAPI_API_KEY']}"}
def create_task(body: dict) -> dict:
    # One Idempotency-Key per logical request: a retry with the same key cannot create a second task.
    headers = {**HEADERS, "Idempotency-Key": str(uuid.uuid4())}
    for attempt in range(3):
        response = requests.post(f"{API}/v1/images/tasks", headers=headers, json=body, timeout=60)
        if response.status_code in (429, 503) and attempt < 2:
            time.sleep(int(response.headers.get("Retry-After", 10)))
            continue
        break
    try:
        payload = response.json()
    except ValueError:  # an edge error page is not JSON
        response.raise_for_status()
        raise
    if not response.ok:
        error = payload["error"]
        raise RuntimeError(f"{response.status_code} {error['code']}: {error['message']} (request_id={error.get('request_id')})")
    return payload["data"]
def wait_for_task(task_id: str, timeout_seconds: int = 1800) -> dict:
    deadline = time.monotonic() + timeout_seconds
    while time.monotonic() < deadline:
        response = requests.get(f"{API}/v1/tasks/{task_id}", headers=HEADERS, timeout=30)
        if response.status_code == 429 or response.status_code >= 500:
            time.sleep(int(response.headers.get("Retry-After", 10)))
            continue
        response.raise_for_status()
        task = response.json()["data"]
        if task["status"] in ("succeeded", "failed"):
            return task
        time.sleep(task.get("poll_after_seconds", 5))
    raise TimeoutError(f"task {task_id} is still running; keep polling later")
task = create_task({
  "model": "nano-banana-2-lite-std",
  "prompt": "A minimalist product photo of a glass water bottle on wet black stone, soft rim light, shallow depth of field",
  "aspect_ratio": "16:9",
  "resolution": "1K"
})
print("created", task["id"])
task = wait_for_task(task["id"])
if task["status"] == "failed":
    raise SystemExit(f"{task['error_code']}: {task['error_message']}")
for item in task["output"]["media"]:
    print(item["url"])

Оплата

• Оплата по токенам по тарифам за 1 млн токенов из таблицы ниже: ввод (промпт и референсы в images), текстовый вывод с рассуждениями и вывод изображения. Токены считает модель; resolution и референсные изображения меняют их число.
• Цены за изображение — оценка по заявленному числу токенов вывода изображения для одной генерации каждого resolution без референсных изображений; референсы и рассуждения добавляются сверху.
• При создании задачи с баланса (и с квоты ключа, если она задана) резервируется оценка для её класса. При успехе списание пересчитывается по токенам, которые фактически ушли на генерацию, поэтому итоговый data.usage может отличаться от резерва. Запрос, отклонённый до создания задачи, бесплатен.
• Неудачная задача возвращается полностью.
• Модель с фиксированной ценой nano-banana-2-lite — та же модель по одной цене за изображение, сколько бы токенов ни ушло на генерацию.

Текущие базовые цены совпадают с указанными на странице цен. Если для аккаунта согласована скидка, стоимость будет ниже. Фактически списанная сумма всегда указана в data.usage задачи.

Частые ошибки

Краткий справочник HTTP-ошибок

Ошибки до создания задачи возвращаются с HTTP-статусом, отличным от 2xx, без списания средств. Обрабатывайте error.code или error.retryable; причина указана в message. Полный список и правила повторов приведены в разделе ошибок.

{
  "error": {
    "code": "bad_request",
    "message": "\"prompt\" is required",
    "retryable": false,
    "request_id": "req_5f0c2a9e4b7d4e31"
  }
}