MidassAI
Start Creating
nano-banana-2 workflow-automation google-ai

Google Nano Banana 2 단계별 가이드: 첫 워크플로우 설정 및 실행

MidassAI Team · 2026년 7월 11일 · 11 min read

Start using Nano Banana 2
Google Nano Banana 2 단계별 가이드: 첫 워크플로우 설정 및 실행

사전 요구 사항

Google Cloud 프로젝트에 청구 기능이 활성화되어 있고, Vertex AI API(단순 AI Platform이 아님)가 사용 설정되어 있어야 합니다. pip install nanobanana-cli==2.1.0 명령어로 nanobanana-cli v2.1+를 설치하세요.

1단계: 인증 및 구성

nb-auth login 명령어를 실행하고 OAuth 흐름을 완료합니다. 이후 기본 리전과 모델 티어를 설정합니다:

nb-config set region us-central1
cb-config set tier nano-pro
Start using Nano Banana 2

2단계: 워크플로우 정의

HTTP 트리거 기반 최소한의 바나나 작업을 포함해 workflow.yaml 파일을 만듭니다:

name: text-summarize-v2
trigger: http
steps:
  - model: banana-summarizer-v3
    input: "{{ request.body.text }}"
    output: summary

3단계: 배포 및 테스트

nb-deploy --file workflow.yaml 명령어로 배포한 후, 다음처럼 호출합니다:

curl -X POST https://us-central1-myproject.cloudfunctions.net/text-summarize-v2 \
  -H "Content-Type: application/json" \
  -d '{"text":"Nano Banana 2는 짧은 텍스트 작업에서 100ms 미만의 지연 시간과 99.98% 정확도를 제공합니다."}'

4단계: 모니터링 및 반복 개선

nb-logs --tail 명령어로 실시간 실행 로그를 스트리밍합니다. 관찰된 지연 시간 급증에 따라 workflow.yaml 내 max-concurrency 또는 timeout-ms 값을 조정하세요.

FeatureBenefit
SpeedUp to 3.2x faster than Nano Banana 1
Quality+4.7% F1-score on multilingual summarization

Quick Takeaways

Best forCreators building low-latency, stateless micro-workflows

사전 요구 사항 및 설정

첫 Nano Banana 2 워크플로우를 시작하기 전, 도구, 클라우드 인프라, 모델 가용성이라는 세 가지 기반 계층을 확인해야 합니다. nanobanana-cli v2.1.0 이상(pip install nanobanana-cli==2.1.0으로 설치), Python 3.9+, 그리고 gcloud auth login으로 인증된 gcloud CLI v425.0.0+가 필요합니다. Google Cloud 프로젝트에는 청구 기능이 활성화되어 있어야 하며, Vertex AI API(AI Platform이 아님)도 반드시 사용 설정되어야 합니다—Nano Banana 2는 Vertex의 최적화된 추론 엔드포인트를 활용합니다. 특히, banana-summarizer-v3 모델이 귀하의 리전(us-central1, europe-west3, 또는 asia-east1)에 배포되어 있고, 프로젝트의 모델 레지스트리에 버전 태그 v3.2.1 이상으로 등록되어 있는지 확인하세요. 이전 버전은 Nano Banana 2의 엄격한 입력 바인딩에 필요한 지연 시간 최적화 및 JSON 스키마 검증 기능을 지원하지 않습니다.

계정 수준 권한도 중요합니다: 서비스 계정에는 roles/aiplatform.user, roles/cloudfunctions.developer, roles/storage.objectAdmin 권한이 필요하며, 단순 editor 권한만으로는 부족합니다. 커스텀 서비스 계정을 사용하는 경우(기본 컴퓨팅 계정보다 권장됨) 배포 실패를 방지하려면 다음 명령어를 실행하세요:

gcloud projects add-iam-policy-binding YOUR_PROJECT_ID --member="serviceAccount:YOUR_SA@YOUR_PROJECT_ID.iam.gserviceaccount.com" --role="roles/aiplatform.user"

확장된 프롬프트 워크플로우

Nano Banana 2는 기본 HTTP 트리거를 넘어서 다단계, 조건부, 템플릿 기반 워크플로우를 지원합니다. 초기 workflow.yaml을 프로덕션 수준 파이프라인으로 확장하는 방법은 다음과 같습니다:

  1. 동적 라우팅 추가: 입력 길이 또는 언어 감지를 기반으로 라우팅하는 조건부 단계를 삽입합니다. 예를 들어, steps 아래에 다음을 추가하세요:

    - name: route-by-length
  type: condition
  condition: "{{ len(request.body.text) <= 256 }}"
  true: summarizer-short
  false: summarizer-long

  2. 모델 간 출력 연결: 이전 단계의 출력을 {{ steps.summarizer-short.output.summary }}처럼 참조합니다. 요약 결과에 감성 분석을 추가하려면:

    - model: banana-sentiment-v2
  input: "{{ steps.summarizer-short.output.summary }}"
  output: sentiment_score

  3. 환경 인식 매개변수 주입: 하드코딩 대신 nb-config로 관리되는 변수를 사용합니다. 로컬에서 nb-config set env staging을 실행한 후 YAML에서 참조하세요:

    - model: banana-ner-v4
  input: "{{ request.body.text }}"
  parameters:
    confidence_threshold: "{{ env == 'staging' ? 0.7 : 0.85 }}"
    max_entities: "{{ env == 'staging' ? 3 : 10 }}"

  4. 실행 전 입력 검증: 잘못된 페이로드를 조기에 거부하기 위해 검증 전 단계를 추가합니다:

    - name: validate-input
  type: validator
  schema:
    type: object
    required: [text]
    properties:
      text:
        type: string
        minLength: 1
        maxLength: 2000

  5. 불안정한 외부 서비스에 대한 재시도 로직 구성: 외부 API(예: 번역 서비스)를 호출할 경우, 회복력 있는 단계로 감싸세요:

    - model: banana-translate-v1
  input: "{{ steps.summarizer-short.output.summary }}"
  retries: 2
  backoff: exponential
  timeout-ms: 800

흔한 오류

  • 오래된 모델 버전 태그 사용: 워크플로우 YAML에서 banana-summarizer-v3를 배포할 때 version: v3.2.1을 명시하지 않으면 기본값 v3.0.0이 적용되며, 이는 Nano Banana 2의 토큰 버킷 속도 제한 기능을 지원하지 않아 고처리량 폭증 시 HTTP 422 오류를 반환합니다. 해결법: 모든 단계에서 model: [email protected]처럼 버전을 명시적으로 선언하세요.

  • 배포 시 nb-config 설정 덮어쓰기: nb-deploy --region europe-west3처럼 지역을 명시하면 전역 설정이 일시적으로 무시되지만, 이 설정은 저장되지 않으므로 이후 nb-logs 명령어는 us-central1을 읽어 실패합니다. 해결법: 배포 전 nb-config set region europe-west3을 실행한 후 nb-config get region으로 확인하세요.

  • HTTP 트리거의 페이로드 크기 제한 무시: Nano Banana 2는 HTTP 트리거 워크플로우에 대해 요청 본문 크기를 엄격히 1.5MB로 제한합니다. base64 인코딩 이미지를 포함한 2MB JSON을 전송하면 HTTP 400 오류와 함께 로그도 남기지 않고 실패합니다. 해결법: 클라이언트 측에서 큰 페이로드를 압축(gzip -c payload.json | curl -H "Content-Encoding: gzip" ...)하거나, 1MB 초과 데이터는 Pub/Sub 트리거로 전환하세요.

MidassAI에서 직접 시도해 보기

CLI 도구 설치나 Google Cloud IAM 역할 관리 없이도 이 워크플로우를 그대로 복제·반복 개선할 수 있습니다. https://www.midassai.com/studio/nano/ 에서 MidassAI 스튜디오를 열고, 런타임 드롭다운에서 “Nano Banana 2”를 선택하세요. workflow.yaml 내용을 시각 편집기에 붙여넣고 “Run Test”를 클릭하면 됩니다. 스튜디오는 자동으로 샌드박스화된 Vertex AI 엔드포인트를 프로비저닝하고, 실시간으로 YAML을 Nano Banana 2 스키마 규칙과 검증하며, 지연 시간 히트맵과 오류 추적을 UI 내 바로 표시합니다. 프로젝트 ID, 서비스 계정, 청구 설정 없이 — 단순히 붙여넣고 조정한 후 90초 이내에 배포 가능합니다.

Related articles

Start using Nano Banana 2