curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3.1-flash-image-official",
    "prompt": "Картина тушью в стиле китайской живописи: горы и реки, многослойные вершины в клубах тумана",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "temperature": 1.0,
      "topP": 0.95,
      "resolution": "1K",
      "personGeneration": "ALLOW_ALL",
      "thinkingConfig": {
        "thinkingLevel": "HIGH"
      }
    }
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-3.1-flash-image-official",
        "prompt": "Картина тушью в стиле китайской живописи: горы и реки, многослойные вершины в клубах тумана",
        "size": "16:9",
        "n": 1,
        "metadata": {
            "temperature": 1.0,
            "topP": 0.95,
            "resolution": "1K",
            "personGeneration": "ALLOW_ALL",
            "thinkingConfig": {
                "thinkingLevel": "HIGH"
            }
        }
    }
)

task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {task['status']}")

const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-3.1-flash-image-official',
    prompt: 'Картина тушью в стиле китайской живописи: горы и реки, многослойные вершины в клубах тумана',
    size: '16:9',
    n: 1,
    metadata: {
      temperature: 1.0,
      topP: 0.95,
      resolution: '1K',
      personGeneration: 'ALLOW_ALL',
      thinkingConfig: {
        thinkingLevel: 'HIGH'
      }
    }
  })
});

const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "gemini-3.1-flash-image-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

gemini-3.1-flash-image-official

Gemini-3.1-Flash Official Генерация изображений

Генерация изображений с использованием модели Google Gemini 3.1 Flash с прямым подключением, поддержка режима мышления и экстремальных соотношений сторон

POST

images

generations

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3.1-flash-image-official",
    "prompt": "Картина тушью в стиле китайской живописи: горы и реки, многослойные вершины в клубах тумана",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "temperature": 1.0,
      "topP": 0.95,
      "resolution": "1K",
      "personGeneration": "ALLOW_ALL",
      "thinkingConfig": {
        "thinkingLevel": "HIGH"
      }
    }
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-3.1-flash-image-official",
        "prompt": "Картина тушью в стиле китайской живописи: горы и реки, многослойные вершины в клубах тумана",
        "size": "16:9",
        "n": 1,
        "metadata": {
            "temperature": 1.0,
            "topP": 0.95,
            "resolution": "1K",
            "personGeneration": "ALLOW_ALL",
            "thinkingConfig": {
                "thinkingLevel": "HIGH"
            }
        }
    }
)

task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {task['status']}")

const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-3.1-flash-image-official',
    prompt: 'Картина тушью в стиле китайской живописи: горы и реки, многослойные вершины в клубах тумана',
    size: '16:9',
    n: 1,
    metadata: {
      temperature: 1.0,
      topP: 0.95,
      resolution: '1K',
      personGeneration: 'ALLOW_ALL',
      thinkingConfig: {
        thinkingLevel: 'HIGH'
      }
    }
  })
});

const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "gemini-3.1-flash-image-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

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

Прямое подключение к Google Vertex AI через нативный API Gemini 3.1 Flash Image
Выбор модели gemini-3.1-flash-image-official через параметр model
Nano Banana 2 aliases: nano-banana-2-lite-official and nano-banana-2-official
Поддержка генерации из текста и из изображения
Поддержка нативных параметров генерации: temperature, topP, maxOutputTokens
Поддержка resolution (1K/2K/4K), personGeneration, imageOutputOptions — конфигурация изображений
Поддержка thinkingConfig — режим мышления для улучшения генерации сложных сцен
Поддержка safetySettings — настройки безопасности контента
Поддержка экстремальных соотношений сторон (4:1, 8:1)
Асинхронное управление задачами через ID задачи

Важное изменение: Для улучшения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 непосредственно в image_urls. Пожалуйста, сначала используйте эндпоинт загрузки изображений для загрузки изображений, а затем используйте полученный URL в этом API.

Авторизация

string

обязательно

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

Authorization: Bearer YOUR_API_KEY

Тело запроса

string

по умолчанию:"gemini-3.1-flash-image-official"

обязательно

Название модели генерации изображенийПример: "gemini-3.1-flash-image-official"

string

обязательно

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

string

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

1:1 - Квадрат
3:2 / 2:3
3:4 / 4:3
4:5 / 5:4
9:16 / 16:9
21:9
4:1 / 8:1 - Экстремальные широкоэкранные пропорции

integer

по умолчанию:1

Количество генерируемых изображенийФиксировано: 1

string[]

Массив URL справочных изображений для генерации из изображения или редактирования⚠️ Поддерживается только формат URL (base64 больше не поддерживается)

Публично доступные URL изображений (http:// или https://)
Используйте эндпоинт загрузки изображений для загрузки локальных изображений

Ограничения:

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

object

Нативные параметры расширения Vertex AI

Показать Показать поля metadata

number

Температура генерации, контролирует случайность выводаДиапазон: 0.0 - 2.0, по умолчанию 1.0

number

Параметр Top-P сэмплированияДиапазон: 0.0 - 1.0, по умолчанию 0.95

integer

Максимальное количество выходных токеновПо умолчанию 32768

string

Разрешение выходного изображения, автоматически преобразуется в imageSize Vertex AIВарианты: 1K, 2K, 4K, по умолчанию 1K

string

Управление генерацией людейВарианты:

ALLOW_ALL — разрешить генерацию всех людей (включая взрослых и детей)
ALLOW_ADULT — разрешить только взрослых
ALLOW_NONE — запретить генерацию людей

object

Конфигурация формата выходного изображения

Показать Поля imageOutputOptions

string

Формат выходного изображенияВарианты: image/png, image/jpeg, image/webp

integer

Качество сжатия (только для JPEG)

object

Конфигурация режима мышления. При включении модель сначала рассуждает, а затем генерирует изображение

Показать Поля thinkingConfig

integer

Бюджет токенов мышления, контролирует глубину рассуждений моделиДиапазон: 0 - 24576, по умолчанию определяется моделью

string

Уровень мышленияВарианты: LOW, MEDIUM, HIGH, MINIMAL

array

Массив настроек безопасности для фильтрации контента

Показать Элементы safetySettings

string

Категория безопасностиВарианты: HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_HARASSMENT

string

Порог фильтрацииВарианты: OFF, BLOCK_LOW_AND_ABOVE, BLOCK_MEDIUM_AND_ABOVE, BLOCK_ONLY_HIGH

Ответ

string

Уникальный идентификатор задачи для запроса статуса

string

Тип объекта, всегда generation.task

string

Используемое название модели

string

Статус задачи

queued - В очереди на обработку
in_progress - Обрабатывается
completed - Успешно завершена
failed - Ошибка

integer

Процент выполнения задачи (0-100)

integer

Время создания задачи (Unix timestamp)

object

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

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3.1-flash-image-official",
    "prompt": "Картина тушью в стиле китайской живописи: горы и реки, многослойные вершины в клубах тумана",
    "size": "16:9",
    "n": 1,
    "metadata": {
      "temperature": 1.0,
      "topP": 0.95,
      "resolution": "1K",
      "personGeneration": "ALLOW_ALL",
      "thinkingConfig": {
        "thinkingLevel": "HIGH"
      }
    }
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "gemini-3.1-flash-image-official",
        "prompt": "Картина тушью в стиле китайской живописи: горы и реки, многослойные вершины в клубах тумана",
        "size": "16:9",
        "n": 1,
        "metadata": {
            "temperature": 1.0,
            "topP": 0.95,
            "resolution": "1K",
            "personGeneration": "ALLOW_ALL",
            "thinkingConfig": {
                "thinkingLevel": "HIGH"
            }
        }
    }
)

task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {task['status']}")

const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gemini-3.1-flash-image-official',
    prompt: 'Картина тушью в стиле китайской живописи: горы и реки, многослойные вершины в клубах тумана',
    size: '16:9',
    n: 1,
    metadata: {
      temperature: 1.0,
      topP: 0.95,
      resolution: '1K',
      personGeneration: 'ALLOW_ALL',
      thinkingConfig: {
        thinkingLevel: 'HIGH'
      }
    }
  })
});

const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "gemini-3.1-flash-image-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

Обзор

Быстрый старт

API чата

API изображений

API видео

Управление задачами

Загрузка файлов

Аккаунт

Часто задаваемые вопросы

Gemini-3.1-Flash Official Генерация изображений

Авторизация

Тело запроса

Ответ

​Авторизация

​Тело запроса

​Ответ

Авторизация

Тело запроса

Ответ