gemini-3.1-flash-image API генерации изображений
gemini-3.1-flash-image (Nano Banana 2): Создавайте изображения, редактируйте по референсам и уточняйте дизайн через Flatkey. Пример использует contents/parts Gemini, а не взаимозаменяемое тело Images API.
Вывод
Предпросмотр
Сгенерировано с Image 2
Сводка запроса
- Конечная точка
- POST /v1beta/models/gemini-3.1-flash-image:generateContent
- ID модели
- gemini-3.1-flash-image
- Соотношение сторон
- 16:9
- Разрешение
- 1K
Только предпросмотр. Войдите, чтобы отправить запрос в Flatkey.
{
"model": "gemini-3.1-flash-image",
"contents": [
{
"role": "user",
"parts": [
{
"text": "Scene: A cloaked figure crouches on a rain-slick elevated walkway beneath massive futuristic bridges. Cyan fog, magenta tower lights, railings, and wet reflections lead toward the distant city. Hold the figure's silhouette, facing direction, cloak edge, camera height, and neon light placement as a cinematic storyboard keyframe. No readable signs, logos, or watermark.\n\nComposition and rendering: Deliver one 16:9 storyboard keyframe, not a collage or an action sequence. Separate foreground, character plane and background through the existing light and atmospheric depth. Keep the stated pose and eyelines readable, and retain environmental landmarks for continuity. Match the described photographic, illustrated or puppet medium; give fabric and surfaces texture appropriate to that medium.\n\nAvoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above."
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "1K"
}
}
}Производительность API
gemini-3.1-flash-image Надёжность и доступность API
Здесь появится телеметрия запросов Flatkey для gemini-3.1-flash-image, когда будет достаточно производственного трафика.
Активность API
gemini-3.1-flash-image Использование и активность запросов API
Отслеживайте объём запросов и успешную активность инференса gemini-3.1-flash-image за последний отчётный период.
gemini-3.1-flash-image цены
gemini-3.1-flash-image Цены и расчёты API
Карточки показывают текущие тарифы Flatkey за входные и выходные токены. Тариф за токен — не фиксированная цена изображения: настройки, референсы и результат влияют на расход. Прямые цены и бесплатные квоты Google автоматически не применяются.
Пополнить баланс
Используйте один баланс Flatkey и API-ключ для моделей изображений, видео, аудио и текста.
- Тип модели
- Текст в изображение
- API
- /v1beta/models/gemini-3.1-flash-image:generateContent
- Основа расчёта
- 1M tokens
- Выходы
- 1
gemini-3.1-flash-image ИИ-генератор изображений и API: основные возможности
Маршрут gemini-3.1-flash-image от Google поддерживает текст · изображение. Категории каталога: Marketing.
Текст в изображение
Опишите объект, композицию, свет и нужный текст. Настройки вывода задавайте полями запроса, а не только промптом.
Эталонное изображение
Добавьте референсы и укажите, что сохранить и изменить. Соблюдайте ограничения из матрицы параметров.
Выходы
Выбирайте только доступные в Playground пропорции и размеры. У Flash, Flash Lite и Pro разные ограничения вывода.
API
Сохраняйте точный ID и структуру contents/parts из примера. Перед пакетной обработкой проверьте небольшой запрос.
Сравнить
gemini-3.1-flash-image Сравнение API: возможности и доступ
Сравните факты каталога для gemini-3.1-flash-image с базовой версией предыдущего поколения перед изменением интеграции.
| Возможность | Предыдущее поколение | gemini-3.1-flash-image |
|---|---|---|
| Провайдер | Не подтверждено в этом снимке каталога | |
| Модальности | Не подтверждено в этом снимке каталога | текст · изображение |
| Контекст | Не подтверждено в этом снимке каталога | Окно контекста не указано в каталоге |
| Конечная точка | Не подтверждено в этом снимке каталога | /v1beta/models/gemini-3.1-flash-image:generateContent |
| Тарификация | Не подтверждено в этом снимке каталога | $0.5/$3 per 1M tokens |
Выберите правильный запрос до интеграции
Проверьте сценарии, текущую стоимость и точный контракт параметров Flatkey.
Считается по текущим настройкам и живому тарифу каталога при наличии фиксированной цены.
- Текущие настройки
- 1×
- Текущий тариф
- $0.06
- Оценка запроса
- Оплата по использованию
Итог зависит от запроса и группы аккаунта; токены и тарифные уровни нельзя свести к одной сумме.
Сценарии и Model ID
Используйте только доступные сценарии. Flatkey сохраняет один публичный ID, тип входа задаёт тело запроса.
Текст в изображение
Создайте изображение из текста.
- ID модели
gemini-3.1-flash-image- Endpoint
/v1beta/models/gemini-3.1-flash-image:generateContent
Изображение по референсу
Используйте референсы для правок и вариантов.
- ID модели
gemini-3.1-flash-image- Endpoint
/v1beta/models/gemini-3.1-flash-image:generateContent
Совместимость параметров
Значения из той же конфигурации, что использует Playground.
aspect_ratioСоотношение сторон1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9
По умолчанию: 1:1image_sizeРазмер1K · 2K · 4K
По умолчанию: 1KimageЛимит референсов4 файлов
Endpoint: /v1beta/models/gemini-3.1-flash-image:generateContentОт первого теста до production
Используйте единый контракт в Playground и API и обрабатывайте проверку, баланс, статус и результат.
Жизненный цикл
- 1
Проверить модель, prompt, референсы и вывод.
- 2
Отправить запрос изображения.
- 3
Прочитать результат или асинхронную задачу.
- 4
Сохранить файл и метаданные.
Проверки production
Не отправляйте неподдерживаемые значения и референсы.
Разделяйте ошибки ключа, баланса, лимитов и группы.
Покажите, какой prompt или файл нужно заменить.
Сохраните task ID, ограничьте повторы и не считайте таймаут успехом.
Библиотека промптов
Примеры промптов gemini-3.1-flash-image для задач: генерация изображений
Начните с промпта gemini-3.1-flash-image для задачи «генерация изображений», затем измените поля запроса в playground.
Сгенерировано с Image 2
Scene: A 16:9 futuristic game loadout frame shows a helmeted rider beside a black-and-orange motorcycle in a rainy industrial hangar. Blue-and-orange interface controls and a circular part-selection panel sit around the vehicle. Keep the rider, motorcycle geometry, wet floor reflections, lighting direction, and selected-part position fixed for a clean equipment swap. No readable words, logos, invented stats, or watermark. Composition and rendering: Deliver one 16:9 game-interface keyframe. Separate the character, held equipment and HUD into clear depth layers; keep slot spacing and icon scale consistent, with the selected item visually dominant. Preserve the scene-specific game art style. Let material edges catch the existing light without letting interface glow obscure the silhouette. Keep all equipment fully inside the frame. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Scene: A poolside sports broadcast catches a swimmer in a blue cap during freestyle, with one arm entering the water and a sharp splash across the lane. Use a low pool-deck camera, blue water, lane markings, and abstract blue lower-third graphics without readable text. Keep swimmer direction, splash shape, and framing consistent; no real athletes, teams, logos, or watermark. Composition and rendering: Deliver one 16:9 broadcast still at the decisive instant. Use coherent perspective for the playing surface and equipment, readable separation between competitors, and a softer crowd behind the action. Keep the principal subject sharp, with directional blur limited to fast extremities and spray. Preserve the specified broadcast angle and reserve overlay areas clear of the action. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Сгенерировано с Image 2
Scene: A metallic wireless-earbud charging case floats open above a glossy black surface while the two matching earbuds hover above their slots. Purple and cyan rim lights define the rounded metal, black interior, reflections, and empty dark background. Preserve the case, earbuds, hinge, highlights, and three-quarter camera angle. No readable branding, extra products, hands, or watermark. Composition and rendering: Deliver one 16:9 commercial product still. Keep the complete product silhouette inside generous crop-safe margins. Resolve edges, seams and material transitions precisely; shape highlights to describe volume without clipping bright surfaces or crushing dark details. Align reflections with the object and light source. Retain the stated camera angle and existing negative space; add no decorative props. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Сгенерировано с Image 2
Scene: A cloaked figure crouches on a rain-slick elevated walkway beneath massive futuristic bridges. Cyan fog, magenta tower lights, railings, and wet reflections lead toward the distant city. Hold the figure's silhouette, facing direction, cloak edge, camera height, and neon light placement as a cinematic storyboard keyframe. No readable signs, logos, or watermark. Composition and rendering: Deliver one 16:9 storyboard keyframe, not a collage or an action sequence. Separate foreground, character plane and background through the existing light and atmospheric depth. Keep the stated pose and eyelines readable, and retain environmental landmarks for continuity. Match the described photographic, illustrated or puppet medium; give fabric and surfaces texture appropriate to that medium. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Сгенерировано с Image 2
Scene: In a wet green park, a man in a coral-red raincoat and yellow boots struggles with an inverted rainbow umbrella in a gust of wind. His arms brace against the bent canopy while rain streaks through the trees and puddles reflect the bright colors. Keep the umbrella shape, body pose, wind direction, and safe footing clear; no injury, readable text, logos, or watermark. Composition and rendering: Deliver one 16:9 physical-comedy still at the described instant. Make the cause of the gag readable through body balance, grip and object spacing. Separate the reaction from the airborne props; retain believable gravity and contact points. Keep the face and important props sharp, with only restrained directional blur on fast edges. Preserve the stated lighting and room or stage layout. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Сгенерировано с Image 2
Scene: A softly faded historical dock scene shows several workers repairing a large wooden boat at a riverside boatyard. Timber ribs, scaffolding, hand tools, smaller boats, and weathered work clothes fill the wide documentary frame. Restore the wood grain, riverbank structures, faces, and natural color aging without modern objects, readable signs, logos, captions, or watermark. Composition and restoration: Deliver one 16:9 archival-style still. Preserve the original framing, period-specific construction and restrained tonal range; retain monochrome, sepia or faded color as described. Recover modest detail in faces, clothing and architecture without synthetic sharpening. Keep fine grain and authentic aging consistent across the frame; repair damage without replacing historical features. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Зачем нужен API gemini-3.1-flash-image
Зачем использовать gemini-3.1-flash-image через Flatkey?
Используйте один шлюз для gemini-3.1-flash-image, управления аккаунтом и остальных моделей каталога.
gemini-3.1-flash-image через единый API
Сохраняйте явные ID модели и endpoint gemini-3.1-flash-image, используя тот же ключ Flatkey для других нагрузок.
Актуальные цены каталога
Проверьте текущие измерения тарификации gemini-3.1-flash-image до отправки запроса и подтвердите итоговую оценку в аккаунте.
Практическая передача модели
Проверьте промпт gemini-3.1-flash-image в открытом playground и перенесите те же настройки в авторизованную интеграцию.
Управление трафиком и маршрутами
Централизуйте ключи, квоты и маршрутизацию gemini-3.1-flash-image, не меняя рабочий процесс приложения для провайдера.
API
gemini-3.1-flash-image API
Четыре способа с одним ключом и каталогом. Выберите вариант, чтобы увидеть рабочий пример.
curl https://router.flatkey.ai/v1beta/models/gemini-3.1-flash-image:generateContent \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-***" \ -d '{"model":"gemini-3.1-flash-image","contents":[{"role":"user","parts":[{"text":"Создайте с помощью gemini-3.1-flash-image качественное изображение продукта: чистая композиция, точный свет, акцент на объекте и реалистичные детали."}]}],"generationConfig":{"responseModalities":["TEXT","IMAGE"],"imageConfig":{"aspectRatio":"1:1","imageSize":"1K"}}}'
Частые вопросы
gemini-3.1-flash-image API
вопросы о ценах, функциях и использовании
Ответы о ценах, возможностях, endpoint и лимитах каталога gemini-3.1-flash-image.




