Skip to main content
POST
Песочница
Введите API-ключ и промпт, затем отправьте запрос. Это обращение к рабочему API — к тому же эндпоинту, который будет вызывать ваш код.
Запросы, отправленные с этой страницы, являются реальными и тарифицируются для вашего ключа. Одно изображение 1K стоит примерно $0.02–0.09 в зависимости от модели. Здесь нет ни песочницы, ни имитации.

Параметры

string
обязательно
Модель для запуска. Принимает gemini-3-pro-image или gemini-3.1-flash-image, точное совпадение обязательно — без псевдонимов и суффиксов -preview.
object
обязательно
Параметры генерации. Любой ключ, не указанный ниже, отклоняется с invalid_params.
string
URL https, на который необходимо отправить готовую задачу методом POST, чтобы пропустить опрос. Должен быть https — любое другое значение будет отклонено во время отправки.

Что возвращается

Отправка возвращает результат сразу, значительно меньше чем за секунду. Изображения нет в этом ответе — генерация выполняется в фоновом режиме.

Затем запросите результат генерации изображения

Этот playground охватывает только запрос на создание. Возьмите id из приведённого выше ответа и проверяйте задачу, пока status не достигнет completed или failed — для изображения 1K это обычно занимает 15–40 секунд.
Завершённая задача содержит массив outputs с URL изображений:
URL результатов не требуют аутентификации и становятся недействительными через 24 часа после создания задачи. Передавайте заголовок User-Agent при их скачивании — CDN доставки возвращает обычный 403 для запросов без него.

Следующие шаги

Обзор

Все параметры, уровни разрешения и измеренная задержка для серии.

API асинхронных задач

Цикл опроса, обратные вызовы и полная таблица ошибок.