---
title: "RunAPI 経由で OpenClaw に Nano Banana を使う — 画像 API ガイド"
url: "https://runapi.ai/ja/openclaw-nano-banana.md"
canonical: "https://runapi.ai/ja/openclaw-nano-banana"
locale: "ja"
model: "nano-banana"
---

# OpenClaw で Nano Banana を使う。

Nano Banana は Google の Gemini ネイティブな画像生成モデルで、生成画像のテキストレンダリングが業界トップクラスです。Pro は最大 4K 解像度を出力し、Nano Banana 2 は拡張アスペクト比で速度に最適化され、Edit は既存画像を編集します。OpenClaw のエージェントは1つの RunAPI キーとエンドポイントで3つのバリアントすべてを呼び出します。

## 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 セットアップガイド →](https://runapi.ai/ja/openclaw)
- [Nano Banana モデル →](https://runapi.ai/ja/models/nano-banana)
- [Model catalog](https://runapi.ai/ja/models)
- [API docs](https://runapi.ai/ja/docs)