OPENCLAW + NANO BANANA

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

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

하나의 API key · 텍스트-이미지 + 편집 엔드포인트 · 최대 4K 출력
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"
}
curl 명령어를 복사하여 테스트하세요 nano-banana
작동 방식

3단계로 OpenClaw에서 Nano Banana 사용하기

1

RunAPI 설정

RUNAPI_API_KEY 환경 변수를 설정하세요. 이미 채팅을 위해 RunAPI를 OpenClaw 프로바이더로 설정했다면, 동일한 key로 Nano Banana 이미지 생성을 사용할 수 있습니다.

export RUNAPI_API_KEY=runapi_xxx
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을 포함하세요.

POST /api/v1/nano_banana/text_to_image
3

결과 받기

응답에는 task_id가 포함됩니다. status가 completed로 변경될 때까지 task status 엔드포인트를 폴링하세요. 완료된 응답에는 생성된 이미지 URL이 포함됩니다. RunAPI SDK와 CLI는 폴링을 자동으로 처리합니다.

task_id: tsk_abc123
파라미터

Nano Banana API 파라미터

파라미터 유형 설명
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.

OpenClaw의 Nano Banana란?

Nano Banana는 Google의 이미지 생성 모델로 2026년 이미지 생성의 기본 선택이라 불립니다. Pro 변형은 LM Arena 리더보드를 새로 쓰며 수동 디자인 도구와의 격차를 좁히는 결과를 냅니다. OpenClaw agent는 하나의 RunAPI 키와 엔드포인트로 세 가지 변형 모두를 호출합니다.

Nano Banana 활용 사례

브랜드 자료 및 마케팅 비주얼

포스터·광고·소셜 미디어 비주얼 콘텐츠를 생성하며, Nano Banana의 브랜드 가이드라인 이해가 특정 색상 체계·스타일 요구사항·디자인 사양에 맞는 이미지를 만들어냅니다.

실제 맥락에서의 제품 시각화

제품을 실제 환경——레스토랑·야외 장면·인테리어——에 배치하며, Nano Banana의 세계 지식이 배경이 시각적으로 정확하고 일관되게 만듭니다.

멀티 스타일 컨셉 탐색

세 가지 변형(Flash·Standard·Pro)에서 동일한 컨셉의 여러 비주얼 스타일을 탐색하며, Flash로 빠르게 반복하고 Pro로 최종 선택을 합니다.

FAQ

Nano Banana + OpenClaw 질문

OpenClaw 일반 설정

아직 설정하지 않으셨나요? OpenClaw용 RunAPI 설정 가이드로 시작하세요.

OpenClaw 설정 가이드 →

Nano Banana 모델 카탈로그

Nano Banana의 모든 변형, 가격, API 문서를 확인하세요.

Nano Banana 모델 →

지금 OpenClaw에서 Nano Banana를 사용해보세요.

무료 RunAPI key를 발급받고, OpenClaw에 프롬프트를 붙여넣어 최대 4K 해상도로 정확한 텍스트 렌더링이 적용된 이미지를 생성하세요.