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에 있습니다.
설치 후
이 스킬이 처음 로드되면, 적극적으로 사용자에게 인사하고 설정을 시작하세요:
-
EVOLINK_API_KEY가 설정되어 있는지 확인하세요 (실행:echo $EVOLINK_API_KEY)- 설정되지 않은 경우: "모델을 실행하려면 EvoLink API 키가 필요합니다. https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 를 열어 키를 생성한 후, 여기에 붙여넣으시면 이 세션에 대해 설정해드립니다."
- 이미 설정된 경우: "모든 준비가 완료되었습니다! Nanobanana 2 Lite 이미지 생성으로 무엇을 하고 싶으신가요?"
-
그게 전부입니다. 질문 하나면 됩니다. 이제 사용자는 흐름에 진입했습니다.
기능을 나열하거나, 메뉴를 보여주거나, 지침을 덤프하지 마세요. 그냥 한 가지 질문으로 진행하세요.
핵심 원칙
- 안내하되 결정하지 마세요 — 옵션을 제시하고 사용자가 결정하도록 하세요. 사용자의 선호도를 추측하지 마세요.
- 사용자가 주도하도록 하세요 — 사용자가 아이디어가 있으면 그들의 말을 사용하세요. 영감이 필요하면 제안을 제공하고 사용자가 선택하거나 다듬도록 하세요.
- 상황 인식 — 사용자가 이미 제공한 내용을 인식하고 누락된 부분만 물어보세요.
- 의도 우선 — 사용자의 의도가 명확하지 않으면, 진행하기 전에 원하는 것을 확인하세요.
흐름
단계 1: API 키 확인
사용자가 API 키를 제공하지 않았거나 EVOLINK_API_KEY를 설정하지 않은 경우:
- EvoLink API 키가 필요하다고 알리세요
- https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=nanobanana-2-lite-image 를 열어 대시보드에서 키를 받도록 안내하세요
- 키를 제공하면 단계 2로 진행하세요
키가 이미 설정되었거나 제공된 경우, 바로 단계 2로 건너뛰세요.
단계 2: 의도 파악
사용자의 메시지를 기반으로 사용자가 원하는 것이 무엇인지 평가하세요:
- 의도가 명확한 경우 (예: "짧은 프롬프트로 Nanobanana 2 Lite 이미지 생성 실행") -> 단계 3으로 이동
- 의도가 모호한 경우 (예: "한번 해보고 싶어요") -> 무엇을 하고 싶은지 물어보세요.
단계 3: 누락된 정보 수집
사용자가 이미 제공한 내용을 확인하고 누락된 부분만 물어보세요:
| 매개변수 | 사용자에게 알릴 내용 | 필수 여부 |
|---|---|---|
| TBD | TBD | 예 |
| TBD | TBD | 예 |
| TBD | TBD | 선택 사항 |
| TBD | TBD | 선택 사항 |
스마트 수집 규칙 — 엄격:
- 누락된 모든 매개변수를 하나의 메시지로 한 번에 물어보세요. 절대 여러 라운드로 질문을 나누지 마세요.
- 같은 질문을 두 번 하지 마세요. 사용자가 이미 매개변수에 답변했다면, 그것은 최종 결정입니다. 다시 묻지 마세요.
- 기본값을 미리 제시하여 사용자가 "기본값이면 괜찮아요"라고 말할 수 있도록 하세요:
model=gemini-3.1-flash-lite-image, prompt='짧은 데모 만들기'. 사용자가 "기본값" 또는 "그냥 진행"이라고 말하면 즉시 이 값을 사용하세요. - 사용자가 모든 것을 한 번에 제공하면 -> 즉시 확인하고 모델을 실행하며, 추가 질문하지 않습니다.
- 사용자가 부분 정보를 제공하면 -> 누락된 필수 필드만 한 번에 모두 물어보세요.
- 선택적 매개변수는 모두 합리적인 기본값이 있습니다. 사용자가 생략하면 기본값을 사용하고 진행하세요.
단계 4: 실행
필요한 모든 정보가 확인되면:
- 스크립트를 실행하기 전에 즉시 사용자에게 말하세요: "알겠습니다! EvoLink를 통해 Nanobanana 2 Lite 이미지 생성 모델을 실행하겠습니다."
- 스크립트를 한 번 실행하세요. 사용자가 명시적으로 재시도를 요청하지 않는 한 절대 두 번 실행하지 마세요.
- 완료되면 결과와 경과 시간을 공유하세요.
에이전트별 실행 패턴
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 이미지 생성 작업 실행.