Skip to main content
POST
Nano Banana 2 Image-to-Image
Generate images with the Nano Banana 2 model based on a text prompt and reference images, with support for configuring the image aspect ratio and quality level.

Request Headers

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

Request Body

string
required
The text prompt used to generate the image. Chinese and English are supported. We recommend keeping it under 1,000 characters.
string | string[]
required
Reference image(s) for image-to-image generation. Supports image URLs or Base64 encoding. You can pass a single image (string) or multiple images (string array).
string
default:"1x1"
The aspect ratio of the output image. The system automatically maps it to the corresponding pixel dimensions.Available values: 1x1, 2x3, 3x2, 3x4, 4x3, 4x5, 5x4, 9x16, 16x9, 21x9
string
default:"1k"
The image generation quality level. Higher quality can generate clearer, more detailed images.Available values: 1k, 2k, 4k
string
default:"url"
The return format for the generated image.Available values: url, b64_json

Response Information

string[]
required
The generated image array. Each element is an image URL (when response_format is url) or a Base64-encoded string (when response_format is b64_json).