Skip to main content
POST
Gemini 3.1 Flash Image VIP Генерация изображений
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.

Выбор версии

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

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

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

Авторизация

string
обязательно
Аутентификация через Bearer YOUR_API_KEY. API Key создаётся в консоли.

Тело запроса

string
по умолчанию:"gemini-3.1-flash-image-preview-vip"
обязательно
Всегда используйте gemini-3.1-flash-image-preview-vip. Обычное имя модели и другие псевдонимы не переключаются автоматически на этот VIP-маршрут.
string
обязательно
Описание изображения, которое нужно сгенерировать или отредактировать. При передаче нескольких референсных изображений можно описать назначение каждого изображения по порядку списка.
string
Соотношение сторон изображения, например 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9.
integer
по умолчанию:1
Одно изображение за запрос. Используйте число 1, а не строку "1".
object[]
Необязательный список референсных изображений, максимум 14 шт. При генерации из текста опустите это поле. Сначала получите доступный URL изображения через API загрузки изображений; не передавайте base64 напрямую.Пример: [{"url": "https://example.com/reference-1.png"}, {"url": "https://example.com/reference-2.png"}]. 14 — это лимит входных референсных изображений, а не количество выходных изображений одного запроса.
object

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

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

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

id в ответе на отправку — это ID задачи. Используйте API запроса задачи изображения, чтобы получить статус и итоговое изображение. Запрос задачи и Webhook-колбэк следуют общим соглашениям асинхронного API изображений.