이 페이지는 바로 사용할 수 있는 에이전트 스킬을 제공합니다. 이미 사용 중인 코딩 에이전트에 추가하고, 자연어(또는 명시적인 명령)를 사용하여 APIYI 플랫폼에서 이미지 생성 및 편집을 위한 Nano Banana 2.1(
gemini-nano-banana-2.1)을 호출할 수 있습니다. 전체 구성은 파일 두 개뿐이므로 복사하여 바로 사용하면 됩니다.이 스킬이 수행하는 작업
단일 통합 스킬입니다. 스크립트는 입력 이미지를 전달하는지 여부를 자동으로 감지하여 텍스트-이미지 변환과 이미지 편집 중에서 선택합니다.텍스트를 이미지로 변환
프롬프트만 입력 → 14가지 화면비와 1K/2K/4K 해상도를 지원하는 완전히 새로운 이미지가 생성됩니다.
이미지 편집
이미지 1개 + 지시사항 → 부분 편집, 스타일 변경, 배경 교체 등을 수행합니다.
다중 이미지 합성
여러 이미지 + 지시사항 1개 → 합성, 비교, 의상 교체 등을 수행합니다.
1:4 / 4:1 / 1:8 / 8:1), 호출당 $0.045/이미지입니다(1K / 2K / 4K 모두 동일한 가격) — 대량 처리에 더 적합합니다. 512px는 지원하지 않으므로, 썸네일 등급이 필요하다면 Nano Banana 2를 사용하십시오.
이를 사용할 수 있는 에이전트
스킬은 기본적으로 폴더입니다. 에이전트가 읽을 지침(
SKILL.md)과 작업을 수행하는 스크립트로 구성됩니다. 따라서 로컬 파일을 읽고 셸 명령을 실행할 수 있는 모든 코딩 에이전트가 이를 사용할 수 있습니다. 예를 들어 Codex, OpenClaw, hermes-agent, Claude Code 등이 해당합니다.유일한 요구 사항은 에이전트를 실행하는 머신(사용자의 컴퓨터 또는 서버)에 Python 3가 설치되어 있고 네트워크 액세스가 가능해야 한다는 것입니다(스크립트가 api.apiyi.com을 직접 호출합니다). 그뿐입니다. 특정 에이전트에 종속되지 않습니다.3단계로 설정하기
① 폴더를 만들고 파일 붙여넣기
다음 두 파일이 포함된 스킬 폴더를 만듭니다(전체 내용은 다음 두 섹션에 나와 있습니다).② 같은 폴더에 키 넣기
APIYI API 키(api.apiyi.com 콘솔에서 생성)를 nano-banana-2-1/.env에 입력합니다.
.env에서 키를 자동으로 읽으므로 추가 구성이나 환경 변수가 필요하지 않습니다.
③ 에이전트에 전달하기
- 스킬을 자동으로 검색하는 에이전트(예: Claude Code): 전체
nano-banana-2-1/폴더를 해당 에이전트의 스킬 디렉터리에 넣습니다. 개인용~/.claude/skills/또는 프로젝트 수준의.claude/skills/(저장소를 통해 공유)에 넣으면 됩니다. - 기타 에이전트: 해당 에이전트의 스킬/플러그인 규칙에 따라 배치하거나, 가장 간단하게는 “이 폴더의 SKILL.md를 읽고 그 지침을 따르십시오”라고 에이전트에 말하면 됩니다.
SKILL.md
아래의 전체 내용으로nano-banana-2-1/SKILL.md을 생성합니다(description에는 “수행하는 작업 + 사용 시점”이 명시되어 있으며, 에이전트는 이를 사용하여 자동으로 트리거합니다).
scripts/nano_banana_2_1.py
Gemini 네이티브 형식을 사용하여nano-banana-2-1/scripts/nano_banana_2_1.py을 생성합니다(APIYI 텍스트-이미지 / 이미지 편집 참조 페이지에 있는 검증된 작동 코드와 동일합니다). 순수 Python 표준 라이브러리만 사용하며 pip install은 필요하지 않습니다:
단일 문장으로 이미지가 생성되는 이유
많은 분이 다음과 같은 의문을 가집니다. 명령어를 입력한 적이 없는데 어떻게 “고양이를 그려 줘”라는 요청만으로 이미지가 생성되는 것일까요? 원리는 다음과 같습니다. 시작 시 에이전트는 각 스킬의SKILL.md에서 description를 먼저 읽습니다(이 스킬이 “무엇을 하며 언제 사용하는지”를 설명하는 매우 짧은 메타데이터입니다). 사용자의 요청이 해당 시나리오(예: “이미지를 그려 / 생성해 / 렌더링해 줘”, “이 이미지를 다음과 같이 편집해 줘”)와 일치하면, 에이전트는 자동으로 스킬을 호출하기로 결정하고, 전체 SKILL.md를 읽은 다음 스크립트를 실행합니다. 이 모든 과정에서 사용자가 어떤 명령어였는지 기억할 필요는 없습니다.
따라서 다음과 같습니다.
- 잘 작성된
description= 더 정확한 자동 트리거입니다. 이 스킬의 설명에는 이미 “이미지를 생성 / 그리기 / 편집 / 합성”과 같은 표현이 포함되어 있습니다. - 에이전트가 추측하지 않기를 원하고 완전히 제어하려면, 아래의 명시적 호출을 사용합니다.
사용 방법
자연어(암시적 트리거)
설치가 완료되면 에이전트와 대화하기만 하면 됩니다.명시적 호출(더 세밀한 제어)
에이전트가 스스로 결정하지 않도록 하려는 경우, 다음 두 가지 명시적 방법을 사용할 수 있습니다.-
슬래시 명령을 지원하는 에이전트(예: Claude Code):
-
모든 에이전트 / 스크립트를 실행하라고 말하기만 하는 방법(가장 범용적):
생성된 이미지가 저장되는 위치
-o가 단순 파일명(예:-o dog.png)인 경우, 이미지는 모두 프로젝트 루트의nano-banana-2-1-output/폴더(자동 생성됨)에 저장되므로 프로젝트에서 바로 찾을 수 있습니다.- “프로젝트 루트” = 스크립트 자체의 위치에서 상위로 이동하며 찾은
.git또는.claude를 포함하는 첫 번째 디렉터리입니다. 따라서 에이전트가 어느 디렉터리에서 실행되더라도 이미지는 찾을 수 없는 임시 디렉터리가 아니라 항상 프로젝트 내부에 저장됩니다. - 스크립트는 이미지마다 전체 절대 경로를 하나씩 출력합니다(예:
Image saved to /Users/you/project/nano-banana-2-1-output/dog.png). - 기본적으로 이미지 1개만 생성됩니다.
-n 3을 사용하면 한 번에 3개가 생성됩니다(최대 5개이며, 그보다 많은 수는 5개로 제한됨). 이 경우-1,-2,-3접미사가 자동으로 추가됩니다. -o가 디렉터리가 포함된 경로(예:-o images/dog.png또는 절대 경로)인 경우 해당 정확한 경로에 저장됩니다(상대 경로는 현재 작업 디렉터리를 기준으로 함). 이 경우nano-banana-2-1-output/에는 저장되지 않습니다.- 이미지 편집도 동일한 방식으로 작동합니다. 출력은 새 파일로 생성되며 원본을 덮어쓰지 않습니다.
Nano Banana 2.1에는 엄격한 콘텐츠 안전성 제어가 적용됩니다. 스크립트가
STOP 이외의 finishReason를 보고하거나 거부 텍스트를 반환하는 경우 콘텐츠를 그에 맞게 수정하고, 동일하게 위반하는 prompt를 반복해서 재시도하지 마십시오.