Gemini 3.1 Flash Image Preview

• Модель: gemini-3.1-flash-image-preview (фиксированная)
• Возможности: Генерация из текста, генерация на основе изображений (до 14 референсов), до 4K, экстремальные соотношения сторон, опциональная привязка к поиску Google

Не вызывайте эту модель через /v1/chat/completions — вы получите 400 с подсказкой использовать Images API.

Эндпоинты

Режим	Эндпоинт	Когда использовать
Синхронный (рекомендуется)	POST https://apimaster.ai/v1/images/generations	Один HTTP-запрос; платформа опрашивает вышестоящий сервис и возвращает { "data": [{ "url" }] }
Асинхронный	POST https://apimaster.ai/v1/images/generations/async → GET https://apimaster.ai/v1/tasks/{task_id}?model=gemini-3.1-flash-image-preview	Длительные задачи, пользовательские очереди

Быстрый старт (синхронный)

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "Киберпанк-город ночью, неоновые огни",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

Успешный ответ

{
  "created": 1782633696,
  "data": [{ "url": "https://apimaster.ai/imgs/1782633695067198543.jpg" }]
}

Установите HTTP-таймаут на чтение ≥ 180 с для 2K/4K. Загружайте или зеркалируйте URL-адреса незамедлительно — они истекают.

Асинхронный поток

Отправка

curl -s "https://apimaster.ai/v1/images/generations/async" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "корги-астронавт на луне",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Ответ на отправку

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K" }]
}

Опрос

curl -s "https://apimaster.ai/v1/tasks/TASK_ID?model=gemini-3.1-flash-image-preview" \
  -H "Authorization: Bearer YOUR_API_KEY"

При успехе читайте data.result.images[0].url. Типичные статусы опроса: in_progress → succeeded / completed.

Подождите 10–20 с перед первым опросом, затем каждые 3–5 с.

Аутентификация

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

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

Поле	Тип	Обязательно	Примечания
model	string	да	gemini-3.1-flash-image-preview
prompt	string	да	Описание сцены
size	string	нет	Соотношение сторон; см. ниже
resolution	string	нет	0.5K / 1K / 2K / 4K, по умолчанию 1K; регистронезависимый
n	integer	нет	Поддерживается только 1 (числовой, не строка)
image_urls	array	нет	Референсные изображения (URL или data URI)
google_search	boolean	нет	Привязка к текстовому поиску Google
google_image_search	boolean	нет	Требует google_search: true

Разрешение и тарифные уровни

Значение	~пиксели	Цена относительно базы 1K
0.5K	~512	как 1K
1K	~1024	базовая
2K	~2048	× 4/3
4K	~4096	× 2

Фактическая стоимость = цена канала × множитель разрешения × групповой коэффициент. См. маркетплейс или логи консоли.

Ошибки

HTTP	Значение
400	Неверные параметры или неправильный эндпоинт (chat)
401	Недействительный API-ключ
402	Недостаточно средств
408	Таймаут синхронного опроса — повторите асинхронно или уменьшите разрешение
500 / 502	Ошибка вышестоящего сервиса или платформы

Неподдерживаемые соотношения сторон могут приводить к ошибке 500, если настроен только один канал.

Примечания

• Журналы использования включают result_url для предварительного просмотра изображения и request_data.effective_resolution.
• Ценообразование зависит от канала и разрешения — см. маркетплейс.