Skip to main content
POST
Gemini 3.1 Flash Image Generation
Generate images from text prompts using the Gemini 3.1 Flash Image Preview model. Supports configurable image size, aspect ratio, and thinking depth for higher-quality generation results.

Request Headers

string
required
Enum value: application/json
string
required
Bearer authentication format: Bearer {{API key}}.

Request Body

string
default:"1K"
Pixel dimensions of the output image (width*height). 0.5K (512px) is only available for Gemini 3.1 Flash.Available values: 0.5K, 1K, 2K, 4K
object
Google Search options
string
required
Text prompt describing the image to generate
string
default:"1:1"
Aspect ratio of the generated image.Available values: 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9
string
default:"image/png"
MIME type of the output image. Supports PNG and JPEG formats.Available values: image/png, image/jpeg

Response Information

string[]
required
List of generated image URLs
object
Model grounding metadata. Returned when Google server-side tools (such as Search) are invoked. Note: Tool invocation depends on Google. Enabling the parameter does not necessarily trigger a tool call 100% of the time.