Supported Models and ParametersImage Models
Gemini 3 Pro Image Preview
Complete parameters, enums, and integration notes for gemini-3-pro-image-preview.
gemini-3-pro-image-preview is designed for quality-first image generation and multi-reference editing.
It supports 1K, 2K, and 4K and does not expose a separate quality field.
Quick Facts
| Item | Value |
|---|---|
| Model ID | gemini-3-pro-image-preview |
| Type | Image |
| Region | Global / CN |
| Best For | quality-first image generation and multi-reference editing |
| Priority | Choose based on speed and quality needs |
Recommended Request Shape
Submit image tasks to POST /v1/generations.
{"model":"gemini-3-pro-image-preview","prompt":"A premium product campaign visual","aspect_ratio":"1:1","resolution":"1K","n":1}Field Reference
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | Yes | - | Must be gemini-3-pro-image-preview |
prompt | string | Yes | - | Image prompt |
reference_images | string[] | No | - | Reference image URL list, up to 14 images |
aspect_ratio | string | No | 1:1 | Output aspect ratio |
resolution | string | No | 1K | Output resolution |
n | integer | No | 1 | Image count |
Supported Enums
| Field | Values |
|---|---|
aspect_ratio | 21:9 16:9 3:2 4:3 5:4 1:1 4:5 3:4 2:3 9:16 |
resolution | 1K, 2K, and 4K |
Integration Notes
- This model has no
qualityfield; control output quality withresolution. - Validate enum values before sending requests.
Smallest Example
{"model":"gemini-3-pro-image-preview","prompt":"A premium product campaign visual"}