ToAPIsToAPIs
Gemini Nano Banana 2.1

Gemini Nano Banana 2.1 Генерация изображений

Генерация и редактирование изображений с Gemini Nano Banana 2.1. До 14 референсных изображений и разрешение 1K, 2K или 4K.

POST
/v1/images/generations

Для пользователей из материкового Китая: используйте https://toapis.cn как Base URL. Замените https://toapis.com на https://toapis.cn в примерах ниже.

Выбор модели

ВерсияModel ID
Стандартнаяgemini-nano-banana-2.1

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

image_urls принимает только общедоступные URL изображений, а не данные base64. Сначала загрузите локальные изображения через API загрузки изображений и получите URL.

Авторизация

Authorizationstringзаголовокобязательно

Все запросы требуют Bearer Token. Получите API Key на странице управления API Key.

Authorization: Bearer YOUR_API_KEY

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

modelstringтелообязательнопо умолчанию: gemini-nano-banana-2.1

Укажите gemini-nano-banana-2.1.

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

Текстовое описание для генерации или редактирования изображения.

sizestringтело

Соотношение сторон выходного изображения. Поддерживаемые значения:

  • 1:1
  • 3:2, 2:3
  • 4:3, 3:4
  • 16:9, 9:16
  • 5:4, 4:5
  • 21:9
  • 1:4, 4:1
  • 1:8, 8:1
nintegerтелопо умолчанию: 1

Количество выходных изображений фиксировано: число 1. Не используйте строку "1".

image_urlsstring[]тело

Массив строк URL референсных изображений для генерации или редактирования. Максимум 14 изображений. Каждый URL должен быть общедоступным. Количество референсных изображений не является количеством выходных изображений.

Максимум 10MB на изображение. Поддерживаемые форматы: .jpeg, .jpg, .png, .webp.

["https://example.com/photo.jpg"]
metadataobjectтело

Дополнительные параметры настройки.

metadata
resolutionstringтелопо умолчанию: 1K

Разрешение выходного изображения. Поддерживаемые значения: 1K, 2K, 4K. По умолчанию: 1K. Используйте заглавную K.

Поля ответа

idstring

ID задачи для запроса статуса и результатов.

objectstring

Всегда generation.task.

modelstring

ID модели, использованный в запросе.

statusstring

Статус задачи: queued, in_progress, completed, failed.

progressinteger

Прогресс задачи в процентах от 0 до 100.

created_atinteger

Время создания задачи, Unix timestamp в секундах.

metadataobject

Метаданные задачи.

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

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gemini-nano-banana-2.1",
  "prompt": "Ночной город в стиле киберпанк с мерцающими неоновыми огнями",
  "size": "16:9",
  "n": 1,
  "metadata": {
    "resolution": "2K"
  }
}'
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gemini-nano-banana-2.1",
  "prompt": "Преобразуй эту фотографию в акварельную картину",
  "size": "1:1",
  "n": 1,
  "image_urls": [
    "https://example.com/photo.jpg"
  ],
  "metadata": {
    "resolution": "2K"
  }
}'
import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-nano-banana-2.1",
        "prompt": "Ночной город в стиле киберпанк с мерцающими неоновыми огнями",
        "size": "16:9",
        "n": 1,
        "metadata": {
            "resolution": "2K"
        }
    }
)
response.raise_for_status()
task = response.json()
print(task["id"])
const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "model": "gemini-nano-banana-2.1",
    "prompt": "Ночной город в стиле киберпанк с мерцающими неоновыми огнями",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "resolution": "2K"
    }
  })
});

if (!response.ok) {
  throw new Error(await response.text());
}
const task = await response.json();
console.log(task.id);

Пример ответа

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "gemini-nano-banana-2.1",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

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

Поле id в ответе на отправку содержит ID задачи. Используйте API статуса задачи изображения для получения статуса и итоговых изображений. Асинхронные уведомления описаны в Webhook задач.