Google Nano Banana 2 Text To Image
Playground
Try it on WavespeedAI!Google’s Nano Banana 2 (Gemini 3.1 Flash Image) is a cutting-edge text-to-image model enabling high-res 4K image generation optimized for phones. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
Google Nano Banana 2 Text-to-Image
Nano Banana 2 Text-to-Image (Gemini 3.1 Flash Image) is Google’s lightweight yet powerful AI image generation model, built for creators who need fast, high-quality visuals from simple text prompts. It transforms words into expressive, realistic images with remarkable clarity, composition, and style diversity — all within seconds.
Why Choose This?
-
Fast generation Optimized for speed while maintaining high visual quality.
-
Multi-resolution support Output in 1K, 2K, or 4K resolution based on your needs.
-
Flexible aspect ratios Multiple options including 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, and 21:9.
-
Cinematic quality Excels at photorealistic scenes with atmospheric lighting and anamorphic lens effects.
-
Prompt Enhancer Built-in tool to automatically improve your descriptions.
-
Format choice Export in PNG or JPEG format.
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Text description of the desired image |
| aspect_ratio | No | Aspect ratio: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 |
| resolution | No | Output resolution: 1k (default), 2k, 4k |
| output_format | No | Output format: png (default), jpeg |
How to Use
- Write your prompt — describe the image in detail, including style, lighting, and composition.
- Choose aspect ratio (optional) — select a preset or leave empty for default.
- Select resolution — choose 1K, 2K, or 4K based on your needs.
- Choose output format — PNG for transparency support, JPEG for smaller file size.
- Use Prompt Enhancer (optional) — click to automatically refine your description.
- Run — submit and download your generated image.
Pricing
| Resolution | Cost |
|---|---|
| 1k | $0.08 |
| 2k | $0.08 |
| 4k | $0.16 |
Best Use Cases
- Cinematic Imagery — Generate atmospheric scenes with anamorphic lens effects and film-like quality.
- Character Portraits — Create detailed character illustrations with specific attributes.
- Social Media Content — Produce eye-catching visuals for various platforms with flexible aspect ratios.
- Marketing & Ads — Generate professional images for campaigns and promotions.
- Concept Art — Visualize creative ideas with photorealistic rendering.
Pro Tips
- Use cinematic language like “anamorphic lens look,” “neon signs reflected in puddles,” or “rainy Tokyo street at night” for atmospheric results.
- Be specific about character attributes (hair color, clothing, accessories) for consistent results.
- Match aspect ratio to your target platform: 9:16 for Stories/Reels, 16:9 for banners, 1:1 for feeds.
- Try the Prompt Enhancer to automatically improve your descriptions.
- 2K offers the best value — same price as 1K with higher resolution.
Notes
- Prompt is the only required field.
- If aspect_ratio is not selected, the model uses a default ratio.
- 4K resolution costs 2× the standard rate.
- Ensure your prompts comply with Google’s Safety Guidelines.
Related Models
- Nano Banana Pro Text-to-Image — Pro tier with enhanced quality.
- Nano Banana Pro Edit — Edit images with text instructions.
- Nano Banana 2 Edit — Image editing capabilities.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/google/nano-banana-2/text-to-image" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"resolution": "1k",
"output_format": "png",
"enable_sync_mode": false,
"enable_base64_output": false
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | The positive prompt for the generation. | |
| aspect_ratio | string | No | - | 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 | The aspect ratio of the generated media. |
| resolution | string | No | 1k | 1k, 2k, 4k | The resolution of the output image. |
| output_format | string | No | png | png, jpeg | The format of the output image. |
| enable_sync_mode | boolean | No | false | - | If set to true, the function will wait for the result to be generated and uploaded before returning the response. It allows you to get the result directly in the response. This property is only available through the API. |
| enable_base64_output | boolean | No | false | - | If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content (empty when status is not completed). |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |