Skip to main content
POST
Nano Banana 2 (text to image)
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: application/json
string
required
Bearer authentication format: Bearer {{API Key}}.

Request Body

string
default:"1K"
Output image pixel dimensions (width*height). 0.5K (512px) is only available for Gemini 3.1 Flash.Possible 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.Possible 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.Possible values: image/png, image/jpeg

Response

array
required
List of generated image URLs
object
Model grounding metadata. Returned when Google server-side tools (e.g., search) are invoked. Note: tool invocation depends on Google. Enabling the parameter makes the tool available but does not guarantee 100% tool invocation.