Skip to main content
POST
Совместимость названий моделей: данный интерфейс также поддерживает алиас nano-banana-pro-ext, эквивалентный gemini-3-pro-image-preview; они взаимозаменяемы и дают одинаковый результат.

Авторизация

string
обязательно
Все API требуют аутентификации с помощью Bearer TokenПолучение API-ключа:Перейдите на страницу управления API-ключами, чтобы получить ваш API-ключДобавьте в заголовок запроса:

Body

string
по умолчанию:"gemini-3-pro-image-preview"
обязательно
Название модели генерации изображенийПоддерживаемые модели:
  • gemini-3-pro-image-preview — Стандартная версия (совместимый алиас nano-banana-pro-ext)
  • gemini-3-pro-image-preview-official — Официальная версия (совместимый алиас nano-banana-pro)
Пример: "gemini-3-pro-image-preview" или "gemini-3-pro-image-preview-official"
Для совместимости со старыми вызовами алиасы nano-banana-pro-ext (соответствует gemini-3-pro-image-preview), nano-banana-pro (соответствует gemini-3-pro-image-preview-official) по-прежнему доступны для использования.
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовое описание для генерации изображения
string
Размер генерируемого изображенияПоддерживаемые форматы:
  • Соотношения: auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
Для генерации из текста при значении size, равном auto, по умолчанию используется 1:1 или 16:9; для генерации из изображения соотношение сторон следует за ответом источника. Рекомендуется указывать соотношение сторон явно.
integer
Количество генерируемых изображенийДиапазон: 1По умолчанию: 1⚠️ Примечание: Должно быть обычным числом (например, 1), без кавычек, иначе возникнет ошибка
string
Разрешение выходного изображенияПоддерживаемые значения:
  • 1K — Разрешение 1K (по умолчанию)
  • 2K — Разрешение 2K
  • 4K — Разрешение 4K
⚠️ Примечание: Генерация изображений 4K в формате base64 занимает больше времени
boolean
по умолчанию:"false"
Использовать ли резервный официальный канал
  • false: Не использовать (по умолчанию)
  • true: Использовать официальный канал
При использовании официального канала (gemini-3-pro-image-preview-official) этот параметр недоступен.
array
Список URL эталонных изображений для генерации из изображения или редактирования изображения💡 Быстрый ввод (область «Try it»):
  1. Нажмите «+ Add an item», чтобы добавить URL изображения
  2. Введите полный URL изображения или данные base64
Лимит: Максимум 14 изображений

Response

integer
Код состояния ответа
array
Массив данных ответа