Communitygithub.com

Nanobanana 2 Lite 이미지 생성

EvoLink를 통한 Nanobanana 2 Lite 이미지 생성 API 예제 및 설치 가능한 에이전트 스킬입니다.

Nanobanana 2 Lite 이미지 생성란 무엇인가요?

이 스킬은 EvoLink 플랫폼을 통해 Nanobanana 2 Lite 이미지 생성 모델을 호출하고 결과를 받을 수 있도록 설계된 AI 에이전트 스킬입니다. 사용자가 이미지 생성 요청을 하면, 스킬은 API 키 확인, 의도 파악, 필요한 파라미터 수집, 그리고 스크립트 실행의 단계를 거쳐 작업을 수행합니다. Claude Code, OpenClaw, OpenCode, Cursor 등 다양한 AI 에이전트 플랫폼에서 동작하며, 각 플랫폼에 최적화된 실행 패턴을 제공합니다. 스킬은 SKILL.md 문서와 셸 스크립트로 구성되어 있어, 에이전트가 자동으로 스크립트 경로를 해석하고 실행합니다. API 키가 없으면 사용자에게 키 생성 페이지를 안내하고, 모든 필수 정보가 모이면 스크립트를 한 번만 실행하여 중복 호출로 인한 크레딧 낭비를 방지합니다. 실행 중에는 상태 업데이트를 사용자에게 전달하고, 완료 시 결과 URL을 제공합니다. 오류 발생 시 친절하고 실행 가능한 안내 메시지를 제공하여 사용자가 문제를 해결할 수 있도록 돕습니다.

지원 대상✓Claude Code~Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add Evolink-AI/nanobanana-2-lite-image-generate-api-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Nanobanana 2 Lite 이미지 생성은(는) 무엇을 하나요?

Nanobanana 2 Lite 이미지 생성 기능이 EvoLink API 엔드포인트와 함께 설치 가능한 에이전트 스킬로 제공됩니다.

이 스킬을 활성화해야 하는 경우

사용자가 다음을 요청할 때 이 스킬을 활성화하세요:

  • Nanobanana 2 Lite 이미지 생성 사용
  • EvoLink를 통한 Nanobanana 2 Lite 이미지 생성 실행
  • 모델 출력 생성
  • API 흐름 테스트

키워드: nanobanana-2-lite-image-generation, evolink, api, agent, skill

스크립트 위치

중요: 이 파일의 모든 스크립트 경로는 이 SKILL.md 파일이 있는 디렉토리를 기준으로 합니다. 스크립트를 실행하기 전에 절대 경로를 확인하세요:

SKILL_DIR = 이 SKILL.md 파일이 포함된 디렉토리
스크립트 = {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh

예를 들어, 이 SKILL.md 파일이 ~/.claude/skills/nanobanana-2-lite-image/SKILL.md에 있다면, 스크립트는 ~/.claude/skills/nanobanana-2-lite-image/scripts/nanobanana-2-lite-image.sh에 있습니다.

설치 후

이 스킬이 처음 로드되면, 적극적으로 사용자에게 인사하고 설정을 시작하세요:

  1. EVOLINK_API_KEY가 설정되어 있는지 확인하세요 (실행: echo $EVOLINK_API_KEY)

  2. 그게 전부입니다. 질문 하나면 됩니다. 이제 사용자는 흐름에 진입했습니다.

기능을 나열하거나, 메뉴를 보여주거나, 지침을 덤프하지 마세요. 그냥 한 가지 질문으로 진행하세요.

핵심 원칙

  1. 안내하되 결정하지 마세요 — 옵션을 제시하고 사용자가 결정하도록 하세요. 사용자의 선호도를 추측하지 마세요.
  2. 사용자가 주도하도록 하세요 — 사용자가 아이디어가 있으면 그들의 말을 사용하세요. 영감이 필요하면 제안을 제공하고 사용자가 선택하거나 다듬도록 하세요.
  3. 상황 인식 — 사용자가 이미 제공한 내용을 인식하고 누락된 부분만 물어보세요.
  4. 의도 우선 — 사용자의 의도가 명확하지 않으면, 진행하기 전에 원하는 것을 확인하세요.

흐름

단계 1: API 키 확인

사용자가 API 키를 제공하지 않았거나 EVOLINK_API_KEY를 설정하지 않은 경우:

키가 이미 설정되었거나 제공된 경우, 바로 단계 2로 건너뛰세요.

단계 2: 의도 파악

사용자의 메시지를 기반으로 사용자가 원하는 것이 무엇인지 평가하세요:

  • 의도가 명확한 경우 (예: "짧은 프롬프트로 Nanobanana 2 Lite 이미지 생성 실행") -> 단계 3으로 이동
  • 의도가 모호한 경우 (예: "한번 해보고 싶어요") -> 무엇을 하고 싶은지 물어보세요.

단계 3: 누락된 정보 수집

사용자가 이미 제공한 내용을 확인하고 누락된 부분만 물어보세요:

매개변수사용자에게 알릴 내용필수 여부
TBDTBD예
TBDTBD예
TBDTBD선택 사항
TBDTBD선택 사항

스마트 수집 규칙 — 엄격:

  • 누락된 모든 매개변수를 하나의 메시지로 한 번에 물어보세요. 절대 여러 라운드로 질문을 나누지 마세요.
  • 같은 질문을 두 번 하지 마세요. 사용자가 이미 매개변수에 답변했다면, 그것은 최종 결정입니다. 다시 묻지 마세요.
  • 기본값을 미리 제시하여 사용자가 "기본값이면 괜찮아요"라고 말할 수 있도록 하세요: model=gemini-3.1-flash-lite-image, prompt='짧은 데모 만들기'. 사용자가 "기본값" 또는 "그냥 진행"이라고 말하면 즉시 이 값을 사용하세요.
  • 사용자가 모든 것을 한 번에 제공하면 -> 즉시 확인하고 모델을 실행하며, 추가 질문하지 않습니다.
  • 사용자가 부분 정보를 제공하면 -> 누락된 필수 필드만 한 번에 모두 물어보세요.
  • 선택적 매개변수는 모두 합리적인 기본값이 있습니다. 사용자가 생략하면 기본값을 사용하고 진행하세요.

단계 4: 실행

필요한 모든 정보가 확인되면:

  1. 스크립트를 실행하기 전에 즉시 사용자에게 말하세요: "알겠습니다! EvoLink를 통해 Nanobanana 2 Lite 이미지 생성 모델을 실행하겠습니다."
  2. 스크립트를 한 번 실행하세요. 사용자가 명시적으로 재시도를 요청하지 않는 한 절대 두 번 실행하지 마세요.
  3. 완료되면 결과와 경과 시간을 공유하세요.

에이전트별 실행 패턴

Claude Code — run_in_background: true 옵션으로 Bash 도구를 사용한 후, 출력 파일을 읽어 진행 상황을 확인하세요:

# 1단계: 백그라운드에서 실행 (먼저 SKILL_DIR 확인)
Bash(command: "{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh \"입력\" --dry-run true", run_in_background: true, timeout: 300000)

# 2단계: 약 30초 대기 후, 백그라운드 작업 출력 파일을 읽어 RESULT_URL= 또는 STATUS_UPDATE 줄 확인

# 3단계: RESULT_URL=<값>이 보이면 사용자에게 전달

OpenClaw / OpenCode / Cursor — 차단 셸 명령어로 스크립트를 실행하세요 (스크립트 자체 내부적으로 폴링을 처리하며, 일반적으로 2~10분 내에 완료됩니다):

EVOLINK_API_KEY=$EVOLINK_API_KEY {SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "입력" --dry-run true

모든 에이전트 — 중요 규칙:

  • 출력에 TASK_SUBMITTED:가 보이면, 작업은 이미 서버에 대기열에 들어간 것입니다. 스크립트를 다시 실행하지 마세요. 재시도는 사용자의 API 크레딧을 낭비합니다.
  • 스크립트는 작업이 준비될 때까지(최대 5분) 차단됩니다. 조기에 종료하지 마세요.
  • 스크립트가 POLL_TIMEOUT으로 시간 초과되면, 작업이 여전히 처리 중일 수 있습니다. 사용자에게 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 를 확인하라고 알리세요.

스크립트 사용법

참고: {SKILL_DIR}을 이 SKILL.md 파일이 포함된 실제 디렉토리로 바꾸세요.

# API 키 설정
export EVOLINK_API_KEY=your_key_here

# 기본
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "짧은 Nanobanana 2 Lite 이미지 생성 데모 만들기"

# 옵션 포함
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "테스트 프롬프트" --dry-run true --timeout TBD

# 고급
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "드라이 런" --help TBD

# 드라이 런 (API 호출 없이 페이로드 미리보기)
{SKILL_DIR}/scripts/nanobanana-2-lite-image.sh "테스트" --dry-run

스크립트 출력 프로토콜

스크립트는 구조화된 줄을 표준 출력에 작성하며, 이를 파싱하고 조치해야 합니다:

줄 형식시점조치
TASK_SUBMITTED: task_id=<id> estimated=<Ns>제출 직후사용자에게 작업이 시작되었음을 확인하세요. API 호출이 성공했음을 의미합니다. 재시도하지 마세요.
STATUS_UPDATE: <메시지>실행 중 약 15초마다사용자에게 전달 — 예: "아직 작업 중입니다. 약 30초 남았습니다..."
RESULT_URL=<값>성공 시추출하여 사용자에게 제시
ELAPSED=<Ns>성공 시선택적으로 소요 시간 언급
POLL_TIMEOUT: task_id=<id> dashboard=<url>폴링이 5분 초과사용자에게 알림: "작업이 이미 완료되었을 수 있습니다. <dashboard_url>를 확인하세요 (작업 ID: <id>)"
ERROR: ... (stderr)실패 시오류 메시지를 사용자에게 표시

중요: TASK_SUBMITTED:가 보이면, 작업은 서버에 대기열에 들어간 것입니다. 스크립트를 다시 실행하지 마세요. 재시도는 사용자의 API 크레딧을 낭비합니다. 스크립트가 로컬에서 시간 초과되더라도 작업은 여전히 완료될 수 있습니다. 사용자에게 https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 에서 대시보드를 확인하라고 알리세요.

오류 처리

친절하고 실행 가능한 메시지를 제공하세요:

오류사용자에게 알릴 내용
잘못되었거나 누락된 키 (401)"API 키가 작동하지 않는 것 같습니다. https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 에서 확인할 수 있습니다."
잔액 부족 (402)"계정 잔액이 부족합니다. https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 에서 크레딧을 추가할 수 있습니다."
속도 제한 (429)"요청이 너무 많습니다. 잠시 기다렸다가 다시 시도해주세요."
콘텐츠 차단 (400)"이 입력이 콘텐츠 모더레이션에 의해 플래그되었습니다. 입력을 조정해보세요."
서비스를 사용할 수 없음 (503)"서비스가 일시적으로 혼잡합니다. 1분 후에 다시 시도해주세요."

모델 기능 요약

사용자가 모델이 무엇을 할 수 있는지 물을 때 사용하세요:

  • API 빠른 시작: 작업을 생성하고, 완료를 폴링하며, 최종 응답을 검사합니다.
  • 에이전트 스킬: SKILL.md와 스크립트를 사용하여 에이전트 실행을 안내합니다.
  • 문제 해결: docs/errors.md와 완전한 예제를 사용하여 일반적인 실패를 디버깅합니다.
  • 릴리스 준비: 공개 릴리스 전에 패키지 메타데이터의 일관성을 유지하세요.

참고 자료

  • references/api-params.md: 전체 API 매개변수 참조
  • scripts/nanobanana-2-lite-image.sh: EvoLink를 통해 Nanobanana 2 Lite 이미지 생성 작업 실행.

관련 스킬