개요
Nano Banana 2 Lite (이 섹션에서는 Nano Banana Lite로 줄여서 표기합니다)는 2026년 6월 30일에 출시된 Google 이미지 모델로, 모델 ID는gemini-3.1-flash-lite-image입니다. 이는 Nano Banana 2(gemini-3.1-flash-image)의 경량, 경제형 버전으로, 속도와 비용에 중점을 둡니다: 이미지당 약 4초, Nano Banana 2보다 약 2.7배 빠르며, Nano Banana 시리즈에서 가장 빠르고 가장 저렴한 등급입니다.
텍스트-투-이미지 API
이미지 편집 API
AI 에이전트로 연동 진행하기
이 프롬프트를 복사하여 Codex / Claude Code / Cursor에 붙여넣으십시오
이 프롬프트는 먼저 이 페이지의 일반 텍스트 버전을 가져온 다음(모든 문서 URL 끝에 .md 추가), 프로젝트 자체의 기술 스택에 맞춰 코드를 작성합니다. 타임아웃 설정, 방어적인 parts 파싱, 업로드 압축, 그리고 Lite가 1K 전용이라는 점이 이미 요구사항에 반영되어 있습니다.
이 프로젝트에 Nano Banana Lite(
gemini-3.1-flash-lite-image) 텍스트 투 이미지 및 이미지 편집 기능을 연동/트러블슈팅하십시오.코드를 수정하기 전에 문서를 먼저 읽으십시오. 이 페이지의 일반 텍스트 버전을 확인하려면 https://docs.apiyi.com/en/api-capabilities/nano-banana-lite-image/overview.md 를 가져오십시오. 더 자세한 매개변수 정보는 다음을 추가하십시오…
- 타임아웃:
POST https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent에서 Gemini 네이티브 포맷을 호출하고 클라이언트 타임…
총 7가지 요구사항이 포함되어 있습니다. 아래 버튼을 사용하여 전체 프롬프트를 복사하십시오.
이 프롬프트가 방지해 주는 문제들
이 프롬프트가 방지해 주는 문제들
APIYI의 Nano Banana Lite를 사용하는 이유는 무엇입니까?
APIYI에서 사용량 기준 1위 모델은 Nano Banana Pro / 2입니다 — 안정적이고 신뢰할 수 있으며 빠릅니다. Lite 티어는 “빠름”과 “저렴함”을 새로운 수준으로 끌어올려 고처리량 시나리오에 이상적입니다. APIYI는 신뢰성, 비용, 통합 전반에서 경험을 깊게 최적화합니다:공식 채널 · Gemini와 동일
/v1beta/models/.../generateContent) 및 OpenAI SDK 패턴과 100% 호환됩니다 — 요청 본문, 응답 필드, 오류 코드가 동일합니다. 코드 변경 없는 마이그레이션입니다.동시 실행 수 제한 없음
token 기반 ~$0.018/호출
전 세계 장벽 없는 접근
api.apiyi.com에 직접 연결할 수 있습니다. 안정적인 지연 시간, 국경 간 아키텍처 재설계 불필요.전체 모델 라인업
전문 엔터프라이즈 지원
핵심 기능
~4s per 이미지
저비용
14개 종횡비
1:1, 4:1, 1:4, 16:9, 9:16을 포함한 14개의 비율을 지원합니다 — 다양한 레이아웃에 적합합니다SynthID 워터마크
버전 비교
과금
- Pay-as-you-go 또는 Pay-as-you-go Priority 선택 → token 기반 과금
- Pay-per-request 또는 Pay-per-request Priority 선택 → 호출당 과금
- ⚠️ Hybrid 과금은 선택하지 마십시오
Token 기반 과금(권장 · Google 공식 요율의 40%)
호출당 과금
그룹 설정
Nano Banana 2 Lite는 APIYI의 기본 채널에서 동작합니다. 별도의 그룹은 필요하지 않습니다:Pay-as-you-go Priority을 선택하십시오. 이유는 세 가지입니다. ① token 기반(토큰당) 과금은 실제로 호출당 약 $0.018로, 호출당 $0.025보다 저렴합니다. ② 단가가 안정적이고 예측 가능합니다. ③ 한 token으로 Lite / Nano Banana 2 token 기반 과금과 Nano Banana Pro 호출당 과금을 모두 커버합니다 — 하나의 token으로 전체 시리즈를 운영할 수 있습니다.
지원되는 해상도 및 종횡비
출력 해상도
지원되는 종횡비(총 14개)
1:1, 1:4, 4:1, 1:8, 8:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
종횡비별 출력 크기(1K, 픽셀)
요청에서aspectRatio을 비율로 설정하고 imageSize은 1K으로 유지하십시오:
FAQ
Nano Banana 2 Lite와 Nano Banana 2의 차이점은 무엇입니까?
Nano Banana 2 Lite와 Nano Banana 2의 차이점은 무엇입니까?
- ✅ 속도: Lite는 약 4초에 생성되며, Nano Banana 2보다 약 2.7배 빠릅니다
- ✅ 가격: Lite의 token 기반 평균은 실제로 약 $0.018/호출이며(Google 요율의 40%), 호출당 $0.025입니다 — 대량 처리에 더 적합합니다
- ⚠️ 해상도: Lite는 1K만 지원하며, Nano Banana 2는 최대 4K까지 지원합니다
- ⚠️ 품질 상한: 최고 품질이 필요하다면 Nano Banana 2 / Pro가 더 좋습니다
gemini-3.1-flash-image을 gemini-3.1-flash-lite-image로 바꾸십시오.Lite와 Nano Banana 2 중 무엇을 선택해야 합니까?
Lite와 Nano Banana 2 중 무엇을 선택해야 합니까?
- 최고의 가성비 / 빠른 배치 생성 / 1K로 충분함 → Lite 선택(~4초, 호출당 $0.025)
- 2K/4K HD가 필요하거나 더 높은 품질이 필요함 → Nano Banana 2 선택(최대 4K, Pro 수준의 품질)
이미지 생성에는 얼마나 걸립니까?
이미지 생성에는 얼마나 걸립니까?
동시 실행 수 제한이 있습니까?
동시 실행 수 제한이 있습니까?
timeout입니다. Lite는 빠르지만, 단일 요청도 피크 혼잡 시 느려질 수 있으므로 클라이언트 timeout을 300초로 설정하십시오.어떤 입력 이미지 형식이 지원됩니까?
어떤 입력 이미지 형식이 지원됩니까?
image/png 및 image/jpeg가 base64 인코딩을 통해 지원됩니다. 이미지 편집 API 레퍼런스를 참조하십시오.출력 이미지에 워터마크가 있습니까?
출력 이미지에 워터마크가 있습니까?
관련 문서
- Nano Banana 2 이미지 생성 - 품질 + 속도 등급, 최대 4K
- Nano Banana Pro 이미지 생성 - 최고 품질의 플래그십
- 이미지 생성 비교 테스트
- API 사용 설명서