---
title: "RunAPI를 통해 Hermes Agent에서 Nano Banana 사용하기 — Image API 가이드"
url: "https://runapi.ai/ko/hermes-nano-banana.md"
canonical: "https://runapi.ai/ko/hermes-nano-banana"
locale: "ko"
model: "nano-banana"
---
# Hermes Agent에서 Nano Banana를 사용하세요.
Nano Banana는 생성된 이미지에서 업계 최고 수준의 텍스트 렌더링을 제공하는 Google의 Gemini 네이티브 이미지 생성 모델입니다. Pro는 최대 4K 해상도를 출력하고, Nano Banana 2는 확장된 종횡비로 속도를 최적화하며, Edit는 기존 이미지를 수정합니다. Hermes Agent는 RunAPI 커스텀 프로바이더를 통해 세 가지 모두를 호출합니다 — ComfyUI나 GPU 설정이 필요 없습니다.
## 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 환경 변수를 설정하세요. 이미 채팅을 위해 Hermes Agent에 RunAPI를 custom:runapi 프로바이더로 설정했다면, 동일한 key와 base_url로 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 엔드포인트를 공유합니다.
### Hermes Agent에서 Nano Banana 텍스트 생성과 이미지 편집을 어떻게 전환하나요?
텍스트-이미지 생성의 경우 생성 변형(nano-banana-pro, nano-banana-2, 또는 nano-banana) 중 하나로 /api/v1/nano_banana/text_to_image에 POST하세요. 편집의 경우 model nano-banana-edit로 /api/v1/nano_banana/edit_image에 POST하고 소스 image_url을 포함하세요. 두 엔드포인트 모두 동일한 custom:runapi 프로바이더와 RUNAPI_API_KEY를 사용합니다.
### Nano Banana 4K 출력 가격은 어떻게 책정되나요?
Nano Banana Pro 가격은 output_resolution에 따라 다릅니다: 1k와 2k는 동일한 요금이며, 4k는 이미지당 더 비쌉니다. Nano Banana 2도 유사한 단계 구조를 따릅니다. 정확한 이미지당 요금은 RunAPI 가격 페이지를 확인하세요. 월 최소 지출이 없습니다.
### Nano Banana가 생성된 이미지 내에서 읽을 수 있는 텍스트를 렌더링할 수 있나요?
네. Nano Banana는 이미지 내 정확한 텍스트 렌더링을 위해 특별히 설계되었습니다. 원하는 단어를 프롬프트에 정확히 포함시키세요 — 대부분의 diffusion 모델이 글자 형태를 왜곡하는 것과 달리 이 모델은 글꼴 배치와 가독성을 네이티브로 처리합니다.
### Hermes Agent에서 Nano Banana를 사용하려면 ComfyUI나 GPU가 필요한가요?
아니요. Hermes Agent는 RunAPI custom:runapi 프로바이더 엔드포인트를 통해 Nano Banana를 호출합니다. RunAPI가 서버 측에서 모든 GPU 인프라를 처리합니다. ComfyUI 워크플로우, 클라우드 GPU 대여, 로컬 VRAM 요구 사항 없이 — 프롬프트를 보내고 이미지 URL을 받으세요.
## Links
- [Crosslink Agent Label](https://runapi.ai/ko/hermes-agent)
- [Crosslink Model Label](https://runapi.ai/ko/models/nano-banana)
- [Model catalog](https://runapi.ai/ko/models)
- [API docs](https://runapi.ai/ko/docs)