OPENCLAW + NANO BANANA

Use Nano Banana in OpenClaw.

Nano Banana is Google's Gemini-native image generation model with industry-leading text rendering in generated images. Pro outputs up to 4K resolution, Nano Banana 2 optimizes for speed with extended aspect ratios, and Edit modifies existing images. OpenClaw agents call all three variants through one RunAPI key and endpoint.

one API key · text to image + edit endpoints · up to 4K output
Use RunAPI to generate an image with Google Nano Banana Pro.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Send a POST request to https://runapi.ai/api/v1/nano_banana/text_to_image.
- Set the model to "nano-banana-pro".
- Write a descriptive prompt. Nano Banana excels at rendering text within images, so include any text overlays in the prompt.
- Optionally set output_resolution to "4k" for maximum quality.
- The response returns a task_id. Poll the task status endpoint until the task completes.
- When the task is complete, retrieve the image URL from the response.
curl -X POST https://runapi.ai/api/v1/nano_banana/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "A minimalist product card for a coffee brand, the text DARK ROAST in bold sans-serif across the top, a steaming cup below, warm studio lighting",
    "aspect_ratio": "4:3",
    "output_resolution": "4k",
    "output_format": "png"
  }'
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "nano-banana-pro"
}
Copy the curl command to test nano-banana
HOW IT WORKS

Use Nano Banana in OpenClaw in three steps

1

Configure RunAPI

Set the RUNAPI_API_KEY environment variable. If you already configured RunAPI as an OpenClaw provider for chat, the same key works for Nano Banana image generation.

export RUNAPI_API_KEY=runapi_xxx
2

Call Nano Banana

Send a POST to the text_to_image endpoint with model set to nano-banana-pro for highest quality, nano-banana-2 for speed, or nano-banana for the base variant. Set output_resolution to 4k on Pro or 2 for maximum detail. For editing, POST to edit_image with nano-banana-edit and include an image_url.

POST /api/v1/nano_banana/text_to_image
3

Get the result

The response includes a task_id. Poll the task status endpoint until status changes to completed. The finished response contains the generated image URL. RunAPI SDKs and the CLI handle polling automatically.

task_id: tsk_abc123
PARAMETERS

Nano Banana API parameters

Parameter Type Description
model string Required. nano-banana-pro (highest quality, 4K), nano-banana-2 (fast, extended ratios), nano-banana (base), or nano-banana-edit (editing).
prompt string Text description of the desired image. Include any text you want rendered in the image — Nano Banana handles typography natively.
image_url string Source image URL. Required for nano-banana-edit, ignored for text_to_image variants.
aspect_ratio string Optional. Output aspect ratio. Pro accepts: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto. Nano Banana 2 adds 1:4, 1:8, 4:1, 8:1.
output_resolution string Optional. Pro and 2 only. Accepted values: 1k, 2k, 4k. Defaults to 1k.
output_format string Optional. Output file format. Accepted values: png, jpeg, jpg.
callback_url string Optional. Webhook URL that receives a POST when the task completes.

What is Nano Banana on OpenClaw?

Nano Banana is Google's image generation model that users call "scary good" and "the default choice" for image generation in 2026. The Pro variant delivers what people describe as "Pro-level quality at Flash speed" -- it broke the LM Arena leaderboard and produces results that close the generational gap with manual design tools. OpenClaw agents call all three variants through one RunAPI key and endpoint.

Nano Banana use cases

Interior design renders

Generate hundreds of room layout variations with accurate furniture placement and lighting, replacing manual 3D rendering for design iteration.

Hero images for landing pages

Create hero images and social ad visuals with real-time knowledge integration, so the generated content reflects current trends and styles.

Book covers with accurate typography

Generate book cover designs with correctly rendered titles and author names, where the typography is part of the image rather than overlaid afterward.

FAQ

Nano Banana + OpenClaw questions

OpenClaw general setup

Not configured yet? Start with the RunAPI setup guide for OpenClaw.

OpenClaw setup guide →

Nano Banana model catalog

See all Nano Banana variants, pricing, and API docs.

Nano Banana models →

Try Nano Banana in OpenClaw today.

Get a free RunAPI key, paste the prompt into OpenClaw, and generate images with accurate text rendering at up to 4K resolution.