HERMES + NANO BANANA

Hermes Agent에서 Nano Banana를 사용하세요.

Nano Banana는 생성된 이미지에서 업계 최고 수준의 텍스트 렌더링을 제공하는 Google의 Gemini 네이티브 이미지 생성 모델입니다. Pro는 최대 4K 해상도를 출력하고, Nano Banana 2는 확장된 종횡비로 속도를 최적화하며, Edit는 기존 이미지를 수정합니다. Hermes Agent는 RunAPI 커스텀 프로바이더를 통해 세 가지 모두를 호출합니다 — ComfyUI나 GPU 설정이 필요 없습니다.

API Key 받기 문서 읽기
하나의 API key · 텍스트-이미지 + 편집 엔드포인트 · 최대 4K 출력 
Use RunAPI to generate an image with Google Nano Banana Pro from Hermes Agent.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Use the custom:runapi provider already configured in Hermes Agent.
- 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단계로 Hermes Agent에서 Nano Banana 사용하기

1

RunAPI 설정

RUNAPI_API_KEY 환경 변수를 설정하세요. 이미 채팅을 위해 Hermes Agent에 RunAPI를 custom:runapi 프로바이더로 설정했다면, 동일한 key와 base_url로 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.

Hermes Agent의 Nano Banana란?

Nano Banana는 유기적인 디자인 기능과 세계 지식 통합으로 알려진 Google 이미지 모델입니다. 실세계 맥락을 이해하는 이미지를 생성합니다——특정 랜드마크·제품 유형·디자인 스타일을 지정하면 추측이 아닌 내장 지식에서 끌어옵니다. Hermes Agent는 RunAPI custom provider를 통해 세 가지 변형 모두를 호출합니다.

Nano Banana 활용 사례

대량 디자인 에셋 생성

Hermes Agent를 통해 여러 비주얼 방향의 디자인 에셋——커버 이미지·썸네일·광고 소재——을 일괄 생성하며, Nano Banana의 높은 프롬프트 준수율이 각 변형을 브리프에 충실하게 유지합니다.

브랜드 요소가 포함된 광고 소재

특정 비주얼 요소·색상 체계·타이포그래피 요구사항이 포함된 광고 소재를 생성하며, Nano Banana의 디자인 지식이 수동 미세 조정 없이 사용 가능한 광고 소재를 만들어냅니다.

UI 프로토타입용 스크린샷

데모·프로토타입·마케팅용 사실적인 UI 스크린샷과 앱 인터페이스 목업을 생성하며, Nano Banana의 인터페이스 디자인 규범 이해를 최대한 활용합니다.

FAQ

Nano Banana + Hermes Agent 질문

Crosslink Agent Title

Crosslink Agent Body

Crosslink Agent Label

Crosslink Model Title

Crosslink Model Body

Crosslink Model Label

Final Cta Title

Final Cta Body

모델 보기 →