> ## 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 Pro Image VIP Генерация изображений

> Gemini 3 Pro Image VIP поддерживает генерацию из текста и из изображения, до 14 референсных изображений.

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

## Выбор версии

| Версия | Лимит референсных изображений | Сценарий использования |
| - | - | - |
| [Обычная версия](https://docs.toapis.com/docs/ru/api-reference/images/gemini-3-pro-image/generation.md) | 6 шт. | Генерация из текста и редактирование с небольшим числом референсов |
| [VIP](https://docs.toapis.com/docs/ru/api-reference/images/gemini-3-pro-image-vip/generation.md) | 14 шт. | Редактирование и компоновка с большим числом референсных изображений |
| [Official](https://docs.toapis.com/docs/ru/api-reference/images/gemini-3-pro-image-official/generation.md) | 14 шт. | Нужен контроль нативных параметров генерации |

Количество референсных изображений — это общее число входных изображений, а не количество выходных изображений. Три версии используют разные ID моделей, поэтому вызывайте их с параметрами и примерами соответствующей страницы.

## Текущая версия

Используйте `model: "gemini-3-pro-image-preview-vip"` для выбора VIP: поддерживается генерация из текста и изображение-в-изображение или редактирование изображений с максимум 14 референсными изображениями.
Подходит для редактирования или компоновки нескольких изображений, когда нужно от 7 до 14 референсных изображений. В запросе с несколькими изображениями можно описать назначение каждого изображения по порядку списка.
Запрос выполняется асинхронно; после успешной отправки получите результат по ID задачи.

> [!WARNING]
>
> `image_urls` поддерживает только URL изображений и не принимает base64 напрямую. Сначала используйте [API загрузки изображений](https://docs.toapis.com/docs/ru/api-reference/uploads/images.md), чтобы получить доступный URL.

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

**Authorization** `string` *required*

Аутентификация через `Bearer YOUR_API_KEY`. API Key создаётся в [консоли](https://toapis.com/dashboard/tokens).

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

**model** `string` *required* (default: gemini-3-pro-image-preview-vip)

Всегда используйте `gemini-3-pro-image-preview-vip`. Обычное имя модели и другие псевдонимы не переключаются автоматически на этот VIP-маршрут.

**prompt** `string` *required*

Описание изображения, которое нужно сгенерировать или отредактировать. При передаче нескольких референсных изображений можно описать назначение каждого изображения по порядку списка.

**size** `string`

Соотношение сторон изображения, например `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`.

**n** `integer` (default: 1)

Одно изображение за запрос. Используйте число `1`, а не строку `"1"`.

**image\_urls** `object[]`

Необязательный список референсных изображений, максимум 14 шт. При генерации из текста опустите это поле.
Сначала получите доступный URL изображения через [API загрузки изображений](https://docs.toapis.com/docs/ru/api-reference/uploads/images.md); не передавайте base64 напрямую.

**Поля референсного изображения**

**url** `string` *required*

Публично доступный URL изображения по HTTP или HTTPS.

Пример: `[{"url": "https://example.com/reference-1.png"}, {"url": "https://example.com/reference-2.png"}]`.
14 — это лимит входных референсных изображений, а не количество выходных изображений одного запроса.

**metadata** `object`

**Разрешение вывода**

**resolution** `string` (default: 2K)

Поддерживаются `1K`, `2K`, `4K`. Если опустить, используется `2K`.

**grounding** `string` (default: none)

Grounding через поиск Google. При включении модель выполняет поиск перед генерацией, и результат может содержать источники в `grounding_metadata`.

Варианты:

* `none` - отключено (по умолчанию)
* `web` - поиск в интернете

Оплачивается за каждый выполненный поисковый запрос: \$0.014 за запрос. При отправке запроса резервируется депозит до 4 запросов, неиспользованная часть возвращается при расчёте.

## Пример запроса

```bash theme={null}
curl --request POST 'https://toapis.com/v1/images/generations' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3-pro-image-preview-vip",
    "prompt": "Сохрани человека с первого изображения, используй фон и цветовую гамму второго изображения и создай портрет при естественном освещении.",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      {"url": "https://example.com/reference-1.png"},
      {"url": "https://example.com/reference-2.png"}
    ],
    "metadata": {"resolution": "2K"}
  }'
```

Замените примерные URL на реальные доступные адреса референсных изображений. Можно добавлять референсные изображения, но их общее число в списке не должно превышать 14.
Для запроса генерации из текста достаточно удалить `image_urls` и изменить промпт.

## Получение результата

`id` в ответе на отправку — это ID задачи. Используйте [API запроса задачи изображения](https://docs.toapis.com/docs/ru/api-reference/tasks/image-status.md), чтобы получить статус и итоговое изображение.
Запрос задачи и [Webhook-колбэк](https://docs.toapis.com/docs/ru/api-reference/webhooks/task-webhooks.md) следуют общим соглашениям асинхронного API изображений.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.