> ## Documentation Index > Fetch the complete documentation index at: https://docs.toapis.com/llms.txt > Use this file to discover all available pages before exploring further. # Gemini-3.1-Flash Official Генерация изображений > Генерация изображений с использованием модели Google Gemini 3.1 Flash с прямым подключением, поддержка режима мышления и экстремальных соотношений сторон > [!NOTE] > > **Для пользователей из материкового Китая:** используйте `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 задачи > [!WARNING] > > **Важное изменение**: Для улучшения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 непосредственно в `image_urls`. Пожалуйста, сначала используйте [эндпоинт загрузки изображений](https://docs.toapis.com/docs/ru/api-reference/uploads/images.md) для загрузки изображений, а затем используйте полученный URL в этом API. ## Авторизация **Authorization** `string` *required* Все эндпоинты требуют аутентификации Bearer Token Получить API Key: Перейдите на [страницу управления API Key](https://toapis.com/console/token) для получения вашего API Key Добавьте в заголовки запроса: ``` Authorization: Bearer YOUR_API_KEY ``` ## Тело запроса **model** `string` *required* (default: gemini-3.1-flash-image-official) Название модели генерации изображений Пример: `"gemini-3.1-flash-image-official"` **prompt** `string` *required* Текстовое описание для генерации изображения **size** `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` - Экстремальные широкоэкранные пропорции **n** `integer` (default: 1) Количество генерируемых изображений Фиксировано: 1 **image\_urls** `string[]` Массив URL справочных изображений для генерации из изображения или редактирования **⚠️ Поддерживается только формат URL (base64 больше не поддерживается)** * Публично доступные URL изображений (http\:// или https\://) * Используйте [эндпоинт загрузки изображений](https://docs.toapis.com/docs/ru/api-reference/uploads/images.md) для загрузки локальных изображений **Ограничения:** * Максимум 14 изображений * Максимальный размер файла: 10MB * Поддерживаемые форматы: .jpeg, .jpg, .png, .webp **metadata** `object` Нативные параметры расширения Vertex AI **Показать поля metadata** **temperature** `number` Температура генерации, контролирует случайность вывода Диапазон: `0.0` - `2.0`, по умолчанию `1.0` **topP** `number` Параметр Top-P сэмплирования Диапазон: `0.0` - `1.0`, по умолчанию `0.95` **maxOutputTokens** `integer` Максимальное количество выходных токенов По умолчанию `32768` **resolution** `string` Разрешение выходного изображения, автоматически преобразуется в imageSize Vertex AI Варианты: `1K`, `2K`, `4K`, по умолчанию `1K` **grounding** `string` (default: none) Grounding через поиск Google. При включении модель выполняет поиск перед генерацией, и результат может содержать источники в `grounding_metadata`. Варианты: * `none` - отключено (по умолчанию) * `web` - поиск в интернете * `image` - поиск по изображениям * `web_image` - поиск в интернете и по изображениям Оплачивается за каждый выполненный поисковый запрос: \$0.014 за запрос. При отправке запроса резервируется депозит до 4 запросов, неиспользованная часть возвращается при расчёте. **personGeneration** `string` Управление генерацией людей Варианты: * `ALLOW_ALL` — разрешить генерацию всех людей (включая взрослых и детей) * `ALLOW_ADULT` — разрешить только взрослых * `ALLOW_NONE` — запретить генерацию людей **imageOutputOptions** `object` Конфигурация формата выходного изображения **Поля imageOutputOptions** **mimeType** `string` Формат выходного изображения Варианты: `image/png`, `image/jpeg`, `image/webp` **compressionQuality** `integer` Качество сжатия (только для JPEG) **thinkingConfig** `object` Конфигурация режима мышления. При включении модель сначала рассуждает, а затем генерирует изображение **Поля thinkingConfig** **thinkingBudget** `integer` Бюджет токенов мышления, контролирует глубину рассуждений модели Диапазон: `0` - `24576`, по умолчанию определяется моделью **thinkingLevel** `string` Уровень мышления Варианты: `LOW`, `MEDIUM`, `HIGH`, `MINIMAL` **safetySettings** `array` Массив настроек безопасности для фильтрации контента **Элементы safetySettings** **category** `string` Категория безопасности Варианты: `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_DANGEROUS_CONTENT`, `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HARASSMENT` **threshold** `string` Порог фильтрации Варианты: `OFF`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH` ## Ответ **id** `string` Уникальный идентификатор задачи для запроса статуса **object** `string` Тип объекта, всегда `generation.task` **model** `string` Используемое название модели **status** `string` Статус задачи * `queued` - В очереди на обработку * `in_progress` - Обрабатывается * `completed` - Успешно завершена * `failed` - Ошибка **progress** `integer` Процент выполнения задачи (0-100) **created\_at** `integer` Время создания задачи (Unix timestamp) **metadata** `object` Метаданные задачи ```bash cURL theme={null} curl --request POST \ --url https://toapis.com/v1/images/generations \ --header 'Authorization: Bearer ' \ --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" } } }' ``` ```python Python theme={null} 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']}") ``` ```javascript JavaScript theme={null} 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}`); ``` ```json 200 theme={null} { "id": "task_img_abc123def456", "object": "generation.task", "model": "gemini-3.1-flash-image-official", "status": "queued", "progress": 0, "created_at": 1703884800, "metadata": {} } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.