---
title: "Use Nano Banana in OpenClaw via RunAPI — Image API Guide"
url: "https://runapi.ai/openclaw-nano-banana.md"
canonical: "https://runapi.ai/openclaw-nano-banana"
locale: "en"
model: "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.

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "nano-banana-pro"
}

```

## How it works

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.
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.
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.

## 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. |

## FAQ

### What is the difference between Nano Banana Pro, 2, and the base variant?

Nano Banana Pro delivers the highest image quality with up to 4K output resolution. Nano Banana 2 is optimized for speed and supports extra aspect ratios like 1:4 and 8:1 for banner and tall formats. The base nano-banana variant is the most affordable option at standard resolution. All three share the same text_to_image endpoint.

### Can Nano Banana render readable text inside generated images?

Yes. Nano Banana is specifically designed for accurate text rendering in images. Include the exact words you want in the prompt — the model handles font placement and legibility natively, unlike most diffusion models that distort letterforms.

### How does Nano Banana 4K output pricing work?

Nano Banana Pro pricing varies by output_resolution: 1k and 2k are the same rate, while 4k costs more per image. Nano Banana 2 follows a similar tier structure. Check the RunAPI pricing page for exact per-image rates. There is no monthly minimum.

### Can I edit existing images with Nano Banana in OpenClaw?

Yes. Use the nano-banana-edit model with the edit_image endpoint. Pass the source image via image_url and describe the desired changes in the prompt. The edit variant supports text-aware modifications, so you can add or change text overlays on existing images.

### Is Nano Banana async or sync?

Async. The create endpoint returns a task_id immediately. Poll the task status endpoint or provide a callback_url to receive a webhook when the image is ready. RunAPI SDKs and the CLI handle polling automatically.


## Links

- [OpenClaw setup guide →](https://runapi.ai/openclaw)
- [Nano Banana models →](https://runapi.ai/models/nano-banana)
- [Model catalog](https://runapi.ai/models)
- [API docs](https://runapi.ai/docs)