Skip to content

Home Docs Model catalog

Overview Models Image, video & speech Coding tools Production API reference

Overview Models Image, video & speech Coding tools Production API reference

Sign in All models

Choose a model

Available models Image request builder

Chat models

Gemini chat GLM-5.3 GLM-5.3 Flash Qwen DeepSeek V4.1 / V4 Grok

gemini-3.1-flash-image-preview

Models Gemini Image

gemini-3.1-flash-image-previewImageExamples verified 2026-09-25

Gemini 3.1 Flash Image Preview

Preview of 3.1 Flash Image, with the same prices and tiers.

Official price: $0.0672/ imageSame price at every tier
Size tiers: 1K · 2K
Images per request: 1–101K ≤ 10 · 2K ≤ 5
Reference images: Up to 14≤ 25 MiB each
Aspect ratios: 1:1 2:3 3:2 3:4 4:3 4:5 5:4 9:16 16:9 21:9
Not supported (returns 400): mask、background=transparent

Notes

Masks and transparent backgrounds aren't supported and return 400.
The "Gemini Official Direct" group has no /v1/images/edits; pass reference images in image / images on generations.
Preview model; for the stable version use gemini-3.1-flash-image.

Build a requestJSON Schema

Available groups

Gemini (all models, incl. image)
Gemini Official Direct

Integration guide

Gemini image generation

Pricing

Official price in USD. Actual charge = official price × group multiplier.

1K: $0.0672 / image
2K: $0.0672 / image
Per token · Input: $0.50 / 1M tokens
Per token · Cached input: $0.05 / 1M tokens
Per token · Output (incl. images): $60 / 1M tokens

Endpoints

POST/v1/images/generations
POST/v1/images/edits
GET/v1/images/tasks?task_id={task_id}

Same family

gemini-3.1-flash-lite-image gemini-3.1-flash-image gemini-3-pro-image gemini-2.5-flash-image

Prices come from the public catalog; limits come from specs exported from the gateway’s validation code. Actual charge = official price × group multiplier.