--- title: RunAPI로 WorkBuddy에서 Nano Banana 사용하기 — MCP 가이드 | RunAPI description: WorkBuddy에서 MCP를 통해 Google Nano Banana로 이미지를 생성하세요. 정확한 텍스트 렌더링, 최대 4K 출력, RunAPI 키 하나로 Pro/2/Edit 변형 모두 지원. url: https://runapi.ai/ko/workbuddy-nano-banana.md canonical: https://runapi.ai/ko/workbuddy-nano-banana locale: ko site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-nano-banana zh-CN: https://runapi.ai/zh-CN/workbuddy-nano-banana es: https://runapi.ai/es/workbuddy-nano-banana ja: https://runapi.ai/ja/workbuddy-nano-banana de: https://runapi.ai/de/workbuddy-nano-banana fr: https://runapi.ai/fr/workbuddy-nano-banana pt-BR: https://runapi.ai/pt-BR/workbuddy-nano-banana ko: https://runapi.ai/ko/workbuddy-nano-banana it: https://runapi.ai/it/workbuddy-nano-banana nl: https://runapi.ai/nl/workbuddy-nano-banana pl: https://runapi.ai/pl/workbuddy-nano-banana tr: https://runapi.ai/tr/workbuddy-nano-banana zh-TW: https://runapi.ai/zh-TW/workbuddy-nano-banana zh-HK: https://runapi.ai/zh-HK/workbuddy-nano-banana ar: https://runapi.ai/ar/workbuddy-nano-banana x-default: https://runapi.ai/workbuddy-nano-banana model: nano-banana --- > HTML version: https://runapi.ai/ko/workbuddy-nano-banana > Site index for agents: https://runapi.ai/llms.txt # WorkBuddy에서 Nano Banana를 사용하세요. Nano Banana는 생성 이미지 내 텍스트 렌더링이 업계 최고 수준인 Google의 Gemini 네이티브 이미지 생성 모델입니다. Pro는 최대 4K 해상도를 출력하고, Nano Banana 2는 확장된 종횡비를 지원하며 속도에 최적화되어 있고, Edit는 기존 이미지를 수정합니다. WorkBuddy는 단일 RunAPI 서버와 하나의 RUNAPI_API_KEY를 통해 세 가지 변형 모두를 MCP 도구로 호출합니다. - [API Key 받기](https://runapi.ai/ko/login) - [문서 읽기](https://runapi.ai/ko/docs/guides) MCP 서버 하나 · 텍스트-이미지 + 편집 도구 · 최대 4K 출력 ### 프롬프트 ```text Use the runapi MCP server to generate an image with Google Nano Banana Pro. Requirements: - Call the runapi create_task tool with service "nano_banana" and action "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 task is async. Poll it with get_task until it completes. - When the task is complete, report the image URL from the task output. ``` ### MCP 설정 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### 응답 ```json { "task_id": "tsk_abc123", "status": "completed", "model": "nano-banana-pro", "output": { "image_url": "https://media.runapi.ai/outputs/tsk_abc123.png", "output_resolution": "4k" } } ``` ## 세 단계로 WorkBuddy에서 Nano Banana 사용하기 1. **RunAPI MCP 서버 추가** - WorkBuddy에 runapi라는 MCP 서버를 등록하고 RUNAPI_API_KEY에서 키를 읽어 streamable HTTP로 https://runapi.ai/mcp 를 가리키도록 설정하세요. RunAPI가 채팅용으로 이미 연결되어 있다면 동일한 서버에서 Nano Banana 이미지 도구도 노출됩니다. `url: https://runapi.ai/mcp auth: Bearer $RUNAPI_API_KEY ` 2. **WorkBuddy에 Nano Banana 작업 요청하기** - 최고 품질은 nano-banana-pro, 속도는 nano-banana-2, 기본 변형은 nano-banana를 사용하여 service를 nano_banana, action을 text_to_image로 설정한 runapi create_task 도구를 호출하도록 워크벤치 에이전트에 요청하세요. Pro 또는 2에서 최대 디테일을 원하면 output_resolution을 4k로 설정하세요. 편집은 nano-banana-edit와 image_url을 사용하여 action을 edit_image로 전환하세요. `create_task(service="nano_banana", action="text_to_image", model="nano-banana-pro", prompt="...", output_resolution="4k") ` 3. **결과 가져오기** - 도구 호출이 task_id를 반환합니다. WorkBuddy는 상태가 completed로 변경될 때까지 get_task 도구로 폴링한 뒤, 생성된 이미지 URL을 워크벤치 대화에 보고합니다. `get_task(service="nano_banana", task_id="tsk_abc123") ` ## Nano Banana 작업 파라미터 | 파라미터 | 유형 | 설명 | | --- | --- | --- | | `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 요청을 받는 webhook URL. | ## WorkBuddy에서 Nano Banana란? Nano Banana는 사용자들이 "놀랍도록 뛰어나다"고 평하며 2026년 이미지 생성의 "기본 선택"이라고 부르는 Google의 이미지 생성 모델입니다. Pro 변형은 "Flash 속도에 Pro 수준 품질"을 제공한다는 평가를 받으며 LM Arena 리더보드를 석권했고, 수동 디자인 도구와의 세대 격차를 줄이는 결과물을 생성합니다. WorkBuddy 에이전트는 동일한 RunAPI MCP 서버에서 키 하나와 추가 플러그인 없이 세 가지 변형 모두를 도구로 호출합니다. ## Nano Banana 활용 사례 - **인테리어 디자인 렌더링** - 정확한 가구 배치와 조명을 포함한 수백 가지 공간 레이아웃 변형을 생성하여 디자인 반복 작업에서 수동 3D 렌더링을 대체합니다. - **랜딩 페이지 히어로 이미지** - WorkBuddy 내에서 작성된 브리프를 바탕으로 히어로 이미지와 소셜 광고 비주얼을 생성하면 이미지 URL이 바로 워크벤치에 반환됩니다. - **정확한 타이포그래피가 적용된 책 표지** - 제목과 저자 이름이 정확하게 렌더링된 책 표지 디자인을 생성합니다. 타이포그래피가 나중에 합성되는 것이 아니라 이미지의 일부로 포함됩니다. ## Nano Banana + WorkBuddy 자주 묻는 질문 ### Nano Banana Pro, 2, 기본 변형의 차이점은 무엇인가요? Nano Banana Pro는 최대 4K 출력 해상도로 가장 높은 이미지 품질을 제공합니다. Nano Banana 2는 속도에 최적화되어 있으며 배너 및 세로형 포맷을 위한 1:4, 8:1 같은 추가 종횡비를 지원합니다. 기본 nano-banana 변형은 표준 해상도에서 가장 저렴한 옵션입니다. 세 가지 모두 runapi MCP 서버에서 동일한 text_to_image 액션을 공유합니다. ### Nano Banana가 생성된 이미지 안에 읽을 수 있는 텍스트를 렌더링할 수 있나요? 예. Nano Banana는 이미지 내 정확한 텍스트 렌더링을 위해 특별히 설계되었습니다. 프롬프트에 원하는 정확한 텍스트를 포함하세요 — 대부분의 확산 모델과 달리 글자를 왜곡하지 않고 폰트 배치와 가독성을 기본으로 처리합니다. ### Nano Banana 4K 출력 가격은 어떻게 책정되나요? Nano Banana Pro 가격은 output_resolution에 따라 달라집니다. 1k와 2k는 동일한 요금이며, 4k는 이미지당 더 많은 비용이 듭니다. Nano Banana 2도 유사한 티어 구조를 따릅니다. 정확한 이미지당 요금은 RunAPI 가격 페이지를 확인하세요. 월 최소 사용량은 없습니다. ### WorkBuddy에서 Nano Banana로 기존 이미지를 편집할 수 있나요? 네. WorkBuddy에 nano-banana-edit 모델로 edit_image 작업을 실행하도록 요청하세요. image_url로 소스 이미지를 전달하고 프롬프트에 원하는 변경 사항을 설명하면 됩니다. Edit 변형은 텍스트 인식 수정을 지원하므로 기존 이미지의 텍스트 오버레이를 추가하거나 변경할 수 있습니다. ### WorkBuddy에서 Nano Banana는 비동기인가요, 동기인가요? 비동기입니다. create_task 도구가 즉시 task_id를 반환하고, WorkBuddy가 이미지가 준비될 때까지 get_task로 폴링합니다 — 대화에서는 완성된 URL만 표시됩니다. callback_url을 설정하면 작업 완료 시 webhook으로도 전달받을 수 있습니다. - [WorkBuddy 설정 가이드 →](https://runapi.ai/ko/workbuddy.md) - 아직 설정하지 않으셨나요? WorkBuddy를 위한 RunAPI MCP 설정 가이드부터 시작하세요. - [Nano Banana 모델 →](https://runapi.ai/ko/models/nano-banana.md) - 모든 Nano Banana 변형, 가격, API 문서를 확인하세요. ## 지금 바로 WorkBuddy에서 Nano Banana를 사용해 보세요. 무료 RunAPI 키를 발급받고, WorkBuddy에 MCP 서버를 추가한 뒤, 최대 4K 해상도로 정확한 텍스트 렌더링이 포함된 이미지를 생성하세요. [모델 보기 →](https://runapi.ai/ko/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/ko/.md) ### 제품 - [모델 카탈로그](https://runapi.ai/ko/models.md) - [요금](https://runapi.ai/ko/pricing.md) - [제공사](https://runapi.ai/ko/models#all-models) ### 개발자 - [문서](https://runapi.ai/ko/docs/guides) - [SDK](https://runapi.ai/ko/sdk.md) - [CLI](https://runapi.ai/ko/cli.md) - [MCP Server](https://runapi.ai/ko/mcp.md) - [x402](https://runapi.ai/ko/x402.md) ### 가이드 - [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md) - [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md) - [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md) ### 회사 - [엔터프라이즈](https://runapi.ai/ko/contact.md) - [문의](https://runapi.ai/ko/contact.md) ### 법적 고지 - [약관](https://runapi.ai/ko/terms.md) - [개인정보](https://runapi.ai/ko/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "ko", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ko", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ko", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/koicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "SoftwareApplication", "name": "WorkBuddy용 RunAPI Nano Banana", "applicationCategory": "DeveloperApplication", "description": "WorkBuddy에서 MCP를 통해 Google Nano Banana로 이미지를 생성하세요. 정확한 텍스트 렌더링, 최대 4K 출력, RunAPI 키 하나로 Pro/2/Edit 변형 모두 지원.", "url": "https://runapi.ai/ko/workbuddy-nano-banana" }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Nano Banana Pro, 2, 기본 변형의 차이점은 무엇인가요?", "acceptedAnswer": { "@type": "Answer", "text": "Nano Banana Pro는 최대 4K 출력 해상도로 가장 높은 이미지 품질을 제공합니다. Nano Banana 2는 속도에 최적화되어 있으며 배너 및 세로형 포맷을 위한 1:4, 8:1 같은 추가 종횡비를 지원합니다. 기본 nano-banana 변형은 표준 해상도에서 가장 저렴한 옵션입니다. 세 가지 모두 runapi MCP 서버에서 동일한 text_to_image 액션을 공유합니다." } }, { "@type": "Question", "name": "Nano Banana가 생성된 이미지 안에 읽을 수 있는 텍스트를 렌더링할 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "예. Nano Banana는 이미지 내 정확한 텍스트 렌더링을 위해 특별히 설계되었습니다. 프롬프트에 원하는 정확한 텍스트를 포함하세요 — 대부분의 확산 모델과 달리 글자를 왜곡하지 않고 폰트 배치와 가독성을 기본으로 처리합니다." } }, { "@type": "Question", "name": "Nano Banana 4K 출력 가격은 어떻게 책정되나요?", "acceptedAnswer": { "@type": "Answer", "text": "Nano Banana Pro 가격은 output_resolution에 따라 달라집니다. 1k와 2k는 동일한 요금이며, 4k는 이미지당 더 많은 비용이 듭니다. Nano Banana 2도 유사한 티어 구조를 따릅니다. 정확한 이미지당 요금은 RunAPI 가격 페이지를 확인하세요. 월 최소 사용량은 없습니다." } }, { "@type": "Question", "name": "WorkBuddy에서 Nano Banana로 기존 이미지를 편집할 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "네. WorkBuddy에 nano-banana-edit 모델로 edit_image 작업을 실행하도록 요청하세요. image_url로 소스 이미지를 전달하고 프롬프트에 원하는 변경 사항을 설명하면 됩니다. Edit 변형은 텍스트 인식 수정을 지원하므로 기존 이미지의 텍스트 오버레이를 추가하거나 변경할 수 있습니다." } }, { "@type": "Question", "name": "WorkBuddy에서 Nano Banana는 비동기인가요, 동기인가요?", "acceptedAnswer": { "@type": "Answer", "text": "비동기입니다. create_task 도구가 즉시 task_id를 반환하고, WorkBuddy가 이미지가 준비될 때까지 get_task로 폴링합니다 — 대화에서는 완성된 URL만 표시됩니다. callback_url을 설정하면 작업 완료 시 webhook으로도 전달받을 수 있습니다." } } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "HowTo", "name": "RunAPI로 WorkBuddy에서 Nano Banana 사용하는 방법", "description": "WorkBuddy에 RunAPI를 MCP 서버로 등록하고, 워크벤치 에이전트에 Nano Banana 텍스트-이미지 또는 편집 작업을 요청한 뒤, 이미지가 준비될 때까지 폴링하도록 합니다.", "step": [ { "@type": "HowToStep", "position": 1, "name": "RunAPI MCP 서버 추가", "text": "WorkBuddy에 runapi라는 MCP 서버를 등록하고 RUNAPI_API_KEY에서 키를 읽어 streamable HTTP로 https://runapi.ai/mcp 를 가리키도록 설정하세요. RunAPI가 채팅용으로 이미 연결되어 있다면 동일한 서버에서 Nano Banana 이미지 도구도 노출됩니다.", "url": "https://runapi.ai/ko/workbuddy-nano-banana#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "WorkBuddy에 Nano Banana 작업 요청하기", "text": "최고 품질은 nano-banana-pro, 속도는 nano-banana-2, 기본 변형은 nano-banana를 사용하여 service를 nano_banana, action을 text_to_image로 설정한 runapi create_task 도구를 호출하도록 워크벤치 에이전트에 요청하세요. Pro 또는 2에서 최대 디테일을 원하면 output_resolution을 4k로 설정하세요. 편집은 nano-banana-edit와 image_url을 사용하여 action을 edit_image로 전환하세요.", "url": "https://runapi.ai/ko/workbuddy-nano-banana#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "결과 가져오기", "text": "도구 호출이 task_id를 반환합니다. WorkBuddy는 상태가 completed로 변경될 때까지 get_task 도구로 폴링한 뒤, 생성된 이미지 URL을 워크벤치 대화에 보고합니다.", "url": "https://runapi.ai/ko/workbuddy-nano-banana#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "홈", "item": "https://runapi.ai/ko" }, { "@type": "ListItem", "position": 2, "name": "WorkBuddy용 RunAPI Nano Banana", "item": "https://runapi.ai/ko/workbuddy-nano-banana" } ] } ] ```