---
title: "RunAPI를 통해 OpenClaw에서 Nano Banana 사용하기 — Image API 가이드"
url: "https://runapi.ai/ko/openclaw-nano-banana.md"
canonical: "https://runapi.ai/ko/openclaw-nano-banana"
locale: "ko"
model: "nano-banana"
---

# OpenClaw에서 Nano Banana를 사용하세요.

Nano Banana는 생성된 이미지에서 업계 최고 수준의 텍스트 렌더링을 제공하는 Google의 Gemini 네이티브 이미지 생성 모델입니다. Pro는 최대 4K 해상도를 출력하고, Nano Banana 2는 확장된 종횡비로 속도를 최적화하며, Edit는 기존 이미지를 수정합니다. OpenClaw 에이전트는 하나의 RunAPI key와 엔드포인트를 통해 세 가지 변형 모두를 호출합니다.

## 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. **RunAPI 설정** — RUNAPI_API_KEY 환경 변수를 설정하세요. 이미 채팅을 위해 RunAPI를 OpenClaw 프로바이더로 설정했다면, 동일한 key로 Nano Banana 이미지 생성을 사용할 수 있습니다.
2. **Nano Banana 호출** — 최고 품질을 위해 model을 nano-banana-pro로, 속도를 위해 nano-banana-2로, 또는 기본 변형인 nano-banana로 설정하여 text_to_image 엔드포인트에 POST를 보내세요. 최대 디테일을 위해 Pro 또는 2에서 output_resolution을 4k로 설정하세요. 편집의 경우 nano-banana-edit와 함께 edit_image에 POST하고 image_url을 포함하세요.
3. **결과 받기** — 응답에는 task_id가 포함됩니다. status가 completed로 변경될 때까지 task status 엔드포인트를 폴링하세요. 완료된 응답에는 생성된 이미지 URL이 포함됩니다. RunAPI SDK와 CLI는 폴링을 자동으로 처리합니다.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 필수. nano-banana-pro (최고 품질, 4K), nano-banana-2 (빠름, 확장 종횡비), nano-banana (기본), 또는 nano-banana-edit (편집). |
| `prompt` | `string` | 원하는 이미지에 대한 텍스트 설명. 이미지에 렌더링하고 싶은 텍스트를 포함하세요 — Nano Banana는 타이포그래피를 네이티브로 처리합니다. |
| `image_url` | `string` | 소스 이미지 URL. nano-banana-edit에는 필수이며, text_to_image 변형에는 무시됩니다. |
| `aspect_ratio` | `string` | 선택 사항. 출력 종횡비. Pro 허용값: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto. Nano Banana 2는 1:4, 1:8, 4:1, 8:1을 추가 지원합니다. |
| `output_resolution` | `string` | 선택 사항. Pro 및 2 전용. 허용값: 1k, 2k, 4k. 기본값은 1k. |
| `output_format` | `string` | 선택 사항. 출력 파일 형식. 허용값: png, jpeg, jpg. |
| `callback_url` | `string` | 선택 사항. 작업 완료 시 POST를 받을 웹훅 URL. |

## FAQ

### Nano Banana Pro, 2, 기본 변형의 차이점은 무엇인가요?

Nano Banana Pro는 최대 4K 출력 해상도로 가장 높은 이미지 품질을 제공합니다. Nano Banana 2는 속도에 최적화되어 있으며 배너 및 세로형 포맷을 위한 1:4, 8:1 같은 추가 종횡비를 지원합니다. 기본 nano-banana 변형은 표준 해상도에서 가장 저렴한 옵션입니다. 세 가지 모두 동일한 text_to_image 엔드포인트를 공유합니다.

### Nano Banana가 생성된 이미지 내에서 읽을 수 있는 텍스트를 렌더링할 수 있나요?

네. Nano Banana는 이미지 내 정확한 텍스트 렌더링을 위해 특별히 설계되었습니다. 원하는 단어를 프롬프트에 정확히 포함시키세요 — 대부분의 diffusion 모델이 글자 형태를 왜곡하는 것과 달리 이 모델은 글꼴 배치와 가독성을 네이티브로 처리합니다.

### Nano Banana 4K 출력 가격은 어떻게 책정되나요?

Nano Banana Pro 가격은 output_resolution에 따라 다릅니다: 1k와 2k는 동일한 요금이며, 4k는 이미지당 더 비쌉니다. Nano Banana 2도 유사한 단계 구조를 따릅니다. 정확한 이미지당 요금은 RunAPI 가격 페이지를 확인하세요. 월 최소 지출이 없습니다.

### OpenClaw에서 Nano Banana로 기존 이미지를 편집할 수 있나요?

네. edit_image 엔드포인트에 nano-banana-edit 모델을 사용하세요. image_url을 통해 소스 이미지를 전달하고 프롬프트에 원하는 변경 사항을 설명하세요. 편집 변형은 텍스트 인식 수정을 지원하므로 기존 이미지에 텍스트 오버레이를 추가하거나 변경할 수 있습니다.

### Nano Banana는 비동기인가요, 동기인가요?

비동기입니다. 생성 엔드포인트는 즉시 task_id를 반환합니다. 이미지가 준비되면 웹훅을 받으려면 task status 엔드포인트를 폴링하거나 callback_url을 제공하세요. RunAPI SDK와 CLI는 폴링을 자동으로 처리합니다.


## Links

- [OpenClaw 설정 가이드 →](https://runapi.ai/ko/openclaw)
- [Nano Banana 모델 →](https://runapi.ai/ko/models/nano-banana)
- [Model catalog](https://runapi.ai/ko/models)
- [API docs](https://runapi.ai/ko/docs)