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

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

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

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

| Версия                                              | Лимит референсных изображений | Сценарий использования                                               |
| --------------------------------------------------- | ----------------------------- | -------------------------------------------------------------------- |
| [Обычная версия](../gemini-3.1-flash/generation)    | 6 шт.                         | Генерация из текста и редактирование с небольшим числом референсов   |
| [VIP](../gemini-3.1-flash-vip/generation)           | 14 шт.                        | Редактирование и компоновка с большим числом референсных изображений |
| [Official](../gemini-3.1-flash-official/generation) | 14 шт.                        | Нужен контроль нативных параметров генерации                         |

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

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

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

<Warning>
  `image_urls` поддерживает только URL изображений и не принимает base64 напрямую. Сначала используйте [API загрузки изображений](../../uploads/images), чтобы получить доступный URL.
</Warning>

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

<ParamField header="Authorization" type="string" required>
  Аутентификация через `Bearer YOUR_API_KEY`. API Key создаётся в [консоли](https://toapis.com/dashboard/tokens).
</ParamField>

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

<ParamField body="model" type="string" default="gemini-3.1-flash-image-preview-vip" required>
  Всегда используйте `gemini-3.1-flash-image-preview-vip`. Обычное имя модели и другие псевдонимы не переключаются автоматически на этот VIP-маршрут.
</ParamField>

<ParamField body="prompt" type="string" required>
  Описание изображения, которое нужно сгенерировать или отредактировать. При передаче нескольких референсных изображений можно описать назначение каждого изображения по порядку списка.
</ParamField>

<ParamField body="size" type="string">
  Соотношение сторон изображения, например `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`.
</ParamField>

<ParamField body="n" type="integer" default={1}>
  Одно изображение за запрос. Используйте число `1`, а не строку `"1"`.
</ParamField>

<ParamField body="image_urls" type="object[]">
  Необязательный список референсных изображений, максимум 14 шт. При генерации из текста опустите это поле.
  Сначала получите доступный URL изображения через [API загрузки изображений](../../uploads/images); не передавайте base64 напрямую.

  <Expandable title="Поля референсного изображения">
    <ParamField body="url" type="string" required>
      Публично доступный URL изображения по HTTP или HTTPS.
    </ParamField>
  </Expandable>

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

<ParamField body="metadata" type="object">
  <Expandable title="Разрешение вывода">
    <ParamField body="resolution" type="string" default="1K">
      Поддерживаются `1K`, `2K`, `4K`. Если опустить, используется `1K`.
    </ParamField>
  </Expandable>
</ParamField>

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

```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.1-flash-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": "1K"}
  }'
```

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

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

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