🔥 최신 출시: Google은 2026년 2월 26일 Nano Banana 2 (
gemini-3.1-flash-image-preview)를 출시했습니다 — Pro급 품질에 Flash 수준 속도이며, 종량제는 이미지당 $0.025까지 가능합니다! Nano Banana 2 문서 보기🆕 2026년 5월 29일 업데이트 (
-preview 제외): Google이 공식 문서를 업데이트하고 안정 버전 모델 이름 **gemini-3-pro-image**를 출시했습니다(-preview 없음). APIYI는 이미 이를 지원합니다.- 기존 이름도 계속 동작합니다:
gemini-3-pro-image-preview는 평소처럼 계속 동작하며, 과금은 변경되지 않았고, 코드 변경은 필요 없습니다. - 두 이름 모두 사용할 수 있습니다: 새
gemini-3-pro-image이름이나 원래의-preview이름 중 어느 쪽이든 사용하실 수 있습니다.
모든 이미지 API는 동기식입니다 — 조회할 작업 ID가 없으며, 클라이언트가 연결을 끊으면 요청은 여전히 과금되지만 결과는 사라집니다. 이 모델에는 넉넉한 타임아웃을 설정하십시오. 이미지 API 필수 사항 및 모범 사례를 참조하십시오.
최신 버전
- Nano Banana 2:
gemini-3.1-flash-image-preview(🔥 2026년 2월 26일 출시) — 세부 정보 보기 - Nano Banana Pro:
gemini-3-pro-image-preview(2025년 11월 20일 출시)
이전 버전
- 공식 출시:
gemini-2.5-flash-image(안정 버전, 10개 가로세로 비율 지원) - 미리보기 버전:
gemini-2.5-flash-image-preview(⚠️ 2025년 10월 30일 제공 중단)
핵심 장점
-
🔥 Nano Banana Pro의 새로운 기능:
- 🎯 4K 고해상도 지원: 1K, 2K, 4K 세 가지 해상도를 지원하며 최대 4096×4096입니다
- 📝 텍스트 렌더링 최강: 이미지 안의 텍스트를 선명하고 읽기 쉽게 표현하여 포스터와 광고에 적합합니다
- ✨ 로컬 편집: 카메라 각도, 초점, 색보정, 장면 조명 조정을 지원합니다
- 🧠 스마트 추론: Gemini 3 Pro를 기반으로 하며, 복잡한 prompt를 더 잘 이해합니다
-
🚀 범용 장점:
- ⚡ 생성 속도: Nano Banana Pro는 약 20초, 이전 버전은 약 10초입니다
- 💰 합리적인 과금: 충전 보너스와 결합하면 매우 높은 가성비를 제공합니다
- 🔄 완전한 호환성: Google 공식 Gemini API 형식과 완전히 호환됩니다
- 🎨 Google 기술: Google의 최신이자 가장 강력한 이미지 생성/편집 기술을 기반으로 합니다
인터랙티브 API 테스트
텍스트-투-이미지 API
이미지를 생성하기 위한 텍스트 prompt를 입력합니다. 온라인 테스트를 위한 인터랙티브 Playground가 제공됩니다.
이미지 편집 API
편집된 이미지를 생성하기 위해 이미지 + 편집 지침을 업로드합니다. 온라인 테스트를 위한 인터랙티브 Playground가 제공됩니다.
AI 에이전트에게 통합을 맡기기
Codex / Claude Code / Cursor로 빌드한다면, 아래 프롬프트를 복사해 에이전트에게 전달하십시오. 그러면 먼저 이 페이지의 평문 버전을 가져오며(아무 docs URL에나
.md를 덧붙이십시오), 그다음 프로젝트의 자체 스택에 맞춰 코드를 작성합니다 — 타임아웃, 방어적 parts 파싱, 업로드 압축, 해상도 매개변수는 이미 요구사항에 포함되어 있습니다.코딩 에이전트에게 Nano Banana Pro 텍스트-이미지 및 이미지 편집을 통합하거나 문제를 해결하게 하십시오. Codex, Claude Code, Cursor 및 유사한 도구에 복사하여 붙여넣으십시오.
이 prompt가 막아주는 문제
이 prompt가 막아주는 문제
APIYI의 Nano Banana Pro를 선택해야 하는 이유는?
Nano Banana Pro / 2는 APIYI에서 사용량 기준 1위 모델입니다 — 안정적이고, 신뢰할 수 있으며, 빠릅니다. 전문 팀과 함께 작업하고 싶다면 APIYI가 올바른 선택입니다. 엄격한 콘텐츠 안전 제어를 갖춘 Google의 플래그십 모델로서, APIYI가 신뢰성, 비용, 통합 전반에서 최적화했습니다:공식 채널 · Gemini와 동일
Google의 기본 Gemini API (
/v1beta/models/.../generateContent)와 OpenAI SDK 패턴과 100% 호환됩니다 — 요청 본문, 응답 필드, 오류 코드가 동일합니다. 코드 수정 없이 마이그레이션할 수 있습니다.동시 실행 수 제한 없음
Google AI Studio의 RPM/RPD 상한에 묶이지 않습니다. 엔터프라이즈 규모의 배치 생성과 피크 트래픽도 쿼터 중단 없이 선형적으로 확장됩니다.
Google 정가의 31-38%
$0.09/image per-call (vs Google 4K $0.24). 충전 보너스와 함께 사용하면 정가의 31.25%까지 낮아집니다 — 4K 절감액은 최대 68.75%입니다.
글로벌 무장벽 액세스
해외 서버나 프록시가 필요 없습니다 — 중국 본토 데이터 센터, 가정용 네트워크 또는 해외 노드에서
api.apiyi.com에 직접 연결할 수 있습니다. 안정적인 지연 시간, 국경 간 재구성 불필요.전체 모델 라인업
같은 시리즈는 Nano Banana 2 (가성비 + Flash 속도), Nano Banana Pro (최고 품질), 그리고 기존 Nano Banana를 모두 포함합니다 — 시나리오에 따라 자유롭게 조합하세요.
전문 엔터프라이즈 지원
저희 팀은 프로덕션 이미지 생성 배포를 전문으로 하며, 모델 선택, 튜닝, 통합에 대한 깊은 경험을 갖추고 있습니다 — PoC부터 프로덕션까지 엔드투엔드 지원을 제공합니다.
호출 방법
Google의 기본 Gemini API 형식을 사용합니다:지원되지 않는 기능
가격 비교
그룹 설정
Nano Banana Pro는 APIYI에서 두 그룹으로 제공됩니다. 대시보드 → 토큰 설정에서 전환하십시오:
왜 1.4x입니까? 1.4x에서도 가격은 Google 정가의 약 50% 수준으로, 공식 가격보다 훨씬 낮습니다. 이는 높은 동시 실행 수 워크로드와 예기치 않은 업스트림 리스크 제어 이벤트를 위한 대체 레인이며, 기업 고객에게 고가용성 보장을 제공합니다. 기본 그룹이 빡빡할 때는 token을
NanoBananaEnterprise로 전환하여 급증을 넘기십시오.
권장 과금 모델: Pay-as-you-go Priority를 선택하십시오 — Nano Banana Pro의 호출당 과금과 Nano Banana 2의 token 기반 과금을 모두 포함하며, 시리즈 전체에 대해 token 하나입니다.
Token settings: Billing model = Pay-as-you-go Priority, primary group = Default, fallback group = NanoBananaEnterprise (1.4x)
호환성 참고 사항
이전에 다음 모델을 사용했다면, 모델 이름만 간단히 바꾸시면 됩니다.최신 버전으로 업그레이드
- 모든 이전 버전 →
gemini-3-pro-image-preview(🔥 추천, Nano Banana Pro)- 4K 고해상도 출력을 지원합니다
- 가장 강력한 텍스트 렌더링 기능을 제공합니다
- 로컬 편집 기능
안정 버전 사용
gpt-4o-image→gemini-2.5-flash-imagesora_image→gemini-2.5-flash-image- Old Nano Banana →
gemini-2.5-flash-image
지원되는 해상도 및 종횡비
출력 해상도
Nano Banana Pro는 3개의 해상도 티어인 1K, 2K, 4K를 지원합니다(512px 티어는 Nano Banana 2 전용입니다).종횡비별 출력 크기(픽셀)
아래 표는 Google 공식 문서를 기준으로 1K / 2K / 4K 해상도 티어 전반의 모든 10개 종횡비에 대한 Nano Banana Pro의 실제 출력 크기를 나열합니다. 요청에서는 비율에aspect_ratio을, 티어에는 image_size(또는 resolution)을 설정합니다.
1:4, 4:1, 1:8, 8:1의 초세로/초가로 비율 또는 512px 저해상도 티어가 필요하면 Nano Banana 2를 사용하십시오(14개 종횡비 + 512px).FAQ
Nano Banana 2와 Pro 중 무엇을 선택해야 합니까?
Nano Banana 2와 Pro 중 무엇을 선택해야 합니까?
최고의 가성비를 원하시면 Nano Banana 2를 선택하십시오 (
gemini-3.1-flash-image-preview):- Pro 수준의 품질 + Flash급 속도
- 사용한 만큼 결제, 이미지당 $0.025까지
- 14개의 종횡비(Pro보다 4개 더 많음)
- 전용 기능: 추론 모드, 이미지 검색 그라운딩
gemini-3-pro-image-preview):- 최고 수준의 충실도
- $0.09/request
Pro 버전과 레거시 버전 중 무엇을 선택해야 합니까?
Pro 버전과 레거시 버전 중 무엇을 선택해야 합니까?
새 프로젝트에 권장: Nano Banana Pro (
gemini-3-pro-image-preview)✅ Pro 버전의 장점:- 4K 초고해상도(1K, 2K, 4K) 지원
- 업계 최고 수준의 텍스트 렌더링 품질
- 고급 로컬 편집 기능
- 공식 과금의 약 38~67%만 부담
gemini-2.5-flash-image)은 다음에 적합합니다:- 예산에 민감한 시나리오(~$0.025/image vs $0.09/image)
- 빠른 생성이 필요한 경우(10초 vs 20초)
- 기존 프로젝트 마이그레이션
다른 이미지 모델에서 Nano Banana로 전환하려면 어떻게 해야 합니까?
다른 이미지 모델에서 Nano Banana로 전환하려면 어떻게 해야 합니까?
모델 이름을
gpt-4o-image 또는 sora_image에서 gemini-3-pro-image-preview(권장 Pro) 또는 gemini-2.5-flash-image(레거시)로 간단히 변경하기만 하면 되며, 다른 매개변수는 그대로 유지합니다.생성된 이미지는 어떤 형식입니까?
생성된 이미지는 어떤 형식입니까?
모델은 base64로 인코딩된 이미지 데이터를 반환하며, 일반적으로 PNG 또는 JPEG 형식입니다. 코드는 형식을 자동으로 감지해 해당 파일 형식으로 저장합니다.
이미지 편집 기능을 지원합니까?
이미지 편집 기능을 지원합니까?
예, Nano Banana Pro는 이미지 생성과 편집을 모두 지원합니다. 이미지 편집 API 레퍼런스를 참조하십시오.
connection reset by peer / write_response_body_failed (500)가 왜 발생합니까?
connection reset by peer / write_response_body_failed (500)가 왜 발생합니까?
전체 오류는 다음과 같습니다:이는 대개 너무 큰 이미지 업로드로 인해 발생합니다 — 요청 본문이 너무 커져 연결이 끊어집니다. 다음 모범 사례를 따르십시오:
- 이미지 수를 제한하십시오: 공식 규칙(프롬프트당 최대 14개 이미지) 안에서 유지하십시오 — 참조 이미지를 너무 많이 넣지 마십시오.
- 이미지별 크기를 제한하십시오: 각 이미지를 5MB 이하로 유지하십시오 — 공식 이미지별 상한은 7MB이며, base64 인코딩은 크기를 대략 1/3 늘리므로 여유를 남겨 두십시오.
- 업로드 전에 프런트엔드에서 압축하십시오: 이미지를 API로 보내기 전에 프런트엔드(또는 서버 측 릴레이)에서 압축하십시오 — 일반적으로 가장 긴 변의 길이를 제한하고, JPEG/WebP로 변환하며, quality 파라미터를 조정합니다.
- URL 입력으로 전환하십시오: Gemini 네이티브 형식은
fileData.fileUri를 통해 이미지 URL 전달을 지원하므로, 지나치게 큰 base64 요청 본문을 완전히 피할 수 있습니다 — Nano Banana Dev Guide를 참조하십시오.