Google · 이미지

Hermes Agent x Nano Banana

Nano Banana는 Gemini에 내장된 Google의 이미지 모델로, 이미지 내 텍스트 정확도를 위한 빠른 생성에 특화되어 있습니다. RunAPI를 통해 모든 Nano Banana 변형이 단일 키를 공유합니다.

5 variants 최저 $0.04 / 회 상업적 사용 지원

Prerequisite: npx runapi mcp install

Prompt

프롬프트 모델

작업에 맞는 경우 nano-banana를 사용하세요: 1K 해상도; 빠른 기본 버전 (2025년 8월).

You have access to RunAPI task tools for Nano Banana.

Available Nano Banana models:
- nano-banana: 1K 해상도; 빠른 기본 버전 (2025년 8월)
  endpoints: /api/v1/nano_banana/text_to_image
  request fields: model, prompt, aspect_ratio
- nano-banana-2: Gemini 3.1 Flash 기반; 최고의 다중 캐릭터 일관성, 4–8초
  endpoints: /api/v1/nano_banana/text_to_image
  request fields: model, prompt, aspect_ratio
- nano-banana-2-lite: 빠른 생성과 반복에 적합한 가장 빠르고 저렴한 Nano Banana 이미지 모델
  endpoints: /api/v1/nano_banana/edit_image, /api/v1/nano_banana/text_to_image
  request fields: model, prompt, aspect_ratio
- nano-banana-edit: 기존 이미지에서 프롬프트 기반 이미지 편집
  endpoints: /api/v1/nano_banana/edit_image
  request fields: model, prompt, source_image_urls
- nano-banana-pro: Gemini 3 Pro 기반; 최대 4K 해상도, 최고의 텍스트 렌더링, 10–20초
  endpoints: /api/v1/nano_banana/text_to_image
  request fields: model, prompt, aspect_ratio

Use the model ID and endpoint that match the user's request.
Example prompt: 볼드 세리프 폰트로 'Never Give Up' 텍스트와 배경에 석양빛 산이 있는 동기부여 포스터를 만들어 주세요.
/api/v1/nano_banana/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/nano_banana/text_to_image를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/nano_banana/text_to_image/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/nano_banana/edit_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/nano_banana/edit_image를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/nano_banana/edit_image/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.

공개 버전 및 엔드포인트

모델 ID 엔드포인트 시작 가격 모델 카탈로그
nano-banana
/api/v1/nano_banana/text_to_image
$0.04 / 회 모델 상세
nano-banana-2
/api/v1/nano_banana/text_to_image
$0.08 / 회 모델 상세
nano-banana-2-lite
/api/v1/nano_banana/edit_image /api/v1/nano_banana/text_to_image
$0.04 / 회 모델 상세
nano-banana-edit
/api/v1/nano_banana/edit_image
$0.04 / 회 모델 상세
nano-banana-pro
/api/v1/nano_banana/text_to_image
$0.18 / 회 모델 상세

검증

Task가 최종 상태에 도달할 때까지 폴링합니다

<model-id>를 선택하면 검증 명령을 생성합니다.

설정

가이드 엔드포인트: <endpoint>

<model-id>를 선택하면 엔드포인트의 공개 입력 계약에 맞는 요청을 생성합니다.
사용 절차

3단계로 시작하기

  1. 모델 ID 선택

    공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다.

  2. RunAPI 설정

    엔드포인트 요청 전에 RUNAPI_API_KEY를 설정합니다.

  3. 결과 검증

    비동기 엔드포인트는 Task가 최종 상태가 될 때까지 같은 엔드포인트를 폴링합니다.

Hermes Agent + Nano Banana로 만들 수 있는 것

  • 전자상거래 카탈로그 이미지

    카탈로그 전체에 같은 조명, 같은 각도, 같은 브랜드 스타일을 적용한 일관된 제품 사진을 생성합니다.

  • UI 목업과 패키지 콘셉트

    글로 작성한 디자인 브리프를 앱, 패키지, 실물 제품의 시각적 목업으로 바꿉니다.

  • 블로그 일러스트와 브랜드 시리즈

    블로그 글이나 소셜 캠페인을 위해 많은 이미지에서 같은 스타일을 유지하는 일관된 비주얼 시리즈를 만듭니다.

Nano Banana을(를) RunAPI + Hermes Agent로 사용하는 이유

  • 5개 변형 모델, 하나의 API 키

    하나의 RunAPI 연결에서 사용 가능한 모델 변형을 선택할 수 있어 통합 방식을 바꿀 필요가 없습니다.

  • 명확한 사용 요금

    요청을 보내기 전에 현재 카탈로그 요금을 확인하세요. 구독이나 최소 사용 금액이 없습니다.

  • 자동화된 작업 워크플로

    수동 폴링 코드를 작성하지 않고 일관된 작업 흐름으로 비동기 결과를 제출하고 확인하고 수집하세요.

Hermes Agent + Nano Banana 자주 묻는 질문

Hermes Agent에서 생성과 편집을 어떻게 전환하나요?

새 이미지는 생성 엔드포인트를, 수정은 원본 이미지와 함께 편집 엔드포인트를 호출하세요. 둘 다 같은 RunAPI 공급자와 API 키를 사용합니다.

Hermes Agent에서 Nano Banana를 쓰려면 ComfyUI나 GPU가 필요한가요?

아니요. RunAPI가 서버에서 모델을 실행합니다. 프롬프트를 보내면 이미지 URL을 받을 수 있으며, ComfyUI 워크플로나 로컬 GPU는 필요 없습니다.

Nano Banana는 이미지 안에 읽을 수 있는 텍스트를 넣을 수 있나요?

네. 넣고 싶은 문구를 프롬프트에 그대로 적으면 모델이 배치와 가독성을 처리합니다. 많은 확산 모델이 어려워하는 부분입니다.

어떤 모델 ID를 사용해야 하나요?

버전 표에서 공개 모델 ID를 선택하세요. 각 ID가 제공하는 엔드포인트는 해당 행에 표시됩니다.

이 가이드는 채팅 모델을 설정하나요?

아니요. 이 Model Line은 여기에 표시된 엔드포인트 절차를 사용하며 Agent 채팅 모델로 제공되지 않습니다.

Hermes Agent에서 Nano Banana 사용 시작하기

팀과 함께 구축하고 계신가요?

엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.

문의하기