Google Nano Banana Text To Image
Playground
Try it on WaveSpeedAI!Google Nano Banana is a cutting-edge text-to-image model that generates images from natural language prompts. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
Nano Banana Text-to-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.
Try the New Version of Nano Banana!
- Nano Banana Pro
- Nano Banana Pro edit
- Nano Banana Pro Ultra
- Nano Banana Pro Edit Ultra
- Nano Banana Pro Multi
๐ Why it stands out
-
Instant Image Creation Generate beautiful, coherent visuals from just a short text prompt โ no design skills required.
-
Versatile Visual Styles Supports realistic, illustrative, anime, and painterly outputs, adapting naturally to your creative intent.
-
Accurate Text-to-Scene Understanding Accurately interprets subjects, backgrounds, and object relationships to create contextually correct compositions.
-
Fast & Efficient Optimized for quick turnaround and minimal compute cost, perfect for rapid prototyping and social content.
-
Clean, Balanced Lighting Produces visually appealing results without overexposure or unnatural shadows โ ideal for portraits, landscapes, and product imagery.
โ๏ธ Capabilities
-
Input: text prompt
-
Output: high-quality image (JPEG/PNG/WEBP)
-
Supports multiple aspect ratios and output format
-
Compatible with descriptive prompts such as:
-
โA golden retriever playing in a field of sunflowers at sunset.โ
-
โA futuristic city skyline with neon reflections on wet streets.โ
-
โAn elegant still-life photo of coffee and croissants by a window.โ
๐ฐ Pricing
- $0.038 per image
- Commercial use allowed
๐ก Best Use Cases
- Social Media & Marketing โ Create on-brand visuals instantly.
- Concept Art & Storyboarding โ Generate design ideas and moodboards effortlessly.
- E-commerce & Advertising โ Produce high-quality product images without photography.
- Education & Presentation โ Visualize complex ideas or creative concepts easily.
๐ Notes
Please ensure your prompts comply with Googleโs Safety Guidelines. If an error occurs, review your prompt for restricted content, adjust it, and try again.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
set -euo pipefail
export WAVESPEED_API_KEY="your-api-key"
REQUEST_BODY=$(cat <<'JSON'
{
"prompt": "A cinematic ocean wave at sunrise, highly detailed",
"aspect_ratio": "1:1",
"output_format": "png"
}
JSON
)
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/google/nano-banana/text-to-image" \
-H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
-H "Content-Type: application/json" \
-d "${REQUEST_BODY}")
TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body \
"${RESULT_URL}" \
-H "Authorization: Bearer ${WAVESPEED_API_KEY}")
RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')
case "${STATUS}" in
completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
created|processing) sleep 2 ;;
*) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
esac
doneParameters
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. |
| output_format | string | No | png | png, jpeg | The format of the output image. |
| enable_sync_mode | boolean | No | false | - | If set to `true`, the request attempts to wait for the generated result and return outputs in the same response. If the result is not ready within the sync wait window, the API can return a timeout body while the task continues processing. This option is only available via the API and is supported only by some models. |
| enable_base64_output | boolean | No | false | - | If set to `true`, the prediction's `output` strings are returned as **naked base64** (no `data:<mime>;base64,` prefix). When `false` (default), outputs are returned as URLs pointing to our CDN. |
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 | Output values, usually URL strings; some models return text strings or structured result objects (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 |
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 |
| data.model | string | Model ID used for the prediction |
| data.outputs | array<string | object> | Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model. |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to poll for the prediction result |
| data.status | string | Status: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created |
| 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 |