Nano banana API — 단일 엔드포인트
Nano banana는 Google Gemini 2.5 Flash Image의 커뮤니티 별칭입니다. reApi의 OpenAI 호환 엔드포인트로 Nano banana 이미지를 생성·편집해 며칠이 아니라 몇 분 만에 프로덕션에 투입합니다.
호출당 과금 — Nano banana를 호출하는 가장 저렴한 방법.
동일한 API 엔드포인트입니다. model 파라미터로 버전을 선택합니다.
자유 텍스트 · 필수 · ≤ 1000자
Provide a prompt or at least one reference image / video / frame.
1:1부터 21:9까지 10가지 비율
Nano banana는 1K로만 렌더링
요청당 1–4장
최대 14장 · 공개 HTTPS URL만 허용
이런 것을 만들 수 있습니다
이 모델로 구동되는 실제 워크플로우입니다.
Nano banana로 상품 사진을 일괄 새 단장
재촬영 없이 기존 이커머스 사진을 편집합니다. 원본 URL을 image_urls에 넣고 변경 사항을 영어 자유 텍스트로 설명하면, Nano banana가 상품 형상은 그대로 두고 주변 장면만 다시 그려서 업데이트된 결과물을 반환합니다. 동일한 프롬프트 템플릿으로 SKU 100개를 돌려도 카탈로그 전체가 시각적으로 일관되게 유지됩니다 — 동일한 조명 언어, 동일한 배경 스타일, 모든 변형이 브랜드에 맞춰집니다.
사진 편집하기
광고 크리에이티브 초안을 몇 초 만에 생성
n=4로 단일 프롬프트에서 히어로 시안 4종을 만들어 스탠드업이 끝나기 전에 베스트 안을 고릅니다. 기본 Nano banana id는 속도와 저렴한 초안에 최적화돼 있고, 투자자 자료나 유료 광고에 더 높은 충실도가 필요할 때는 `gemini-2.5-flash-image-preview-official`로 전환합니다. 같은 엔드포인트, 같은 JSON 본문 — 초안과 최종본 사이에서 model id 한 줄만 바뀝니다.
참고 이미지를 하나의 구도로 합성
최대 14장의 참고 이미지를 전달하고 어떻게 결합할지 설명하세요. Nano banana는 단일 호출에서 인물 + 배경 + 스타일 참고를 모두 처리합니다 — 상품 사진과 무드보드 한 장, 브랜드 컬러 팔레트 스와치를 함께 던지면 모델이 이를 새로운 온브랜드 컷으로 합성해 냅니다. 별도 mask 파일도, 별도 합성 단계도 필요 없습니다. 공개 HTTPS URL만 허용되므로 자체 R2 / S3 / OSS에 먼저 업로드하세요.
가격
크레딧 기반 — 1 크레딧 = 0.001 USD. 성공한 생성에 대해서만 비용을 지불합니다.
| 모드 | 카테고리 | 단위 | 가격 |
|---|---|---|---|
| Default | |||
| 1K | 1 image | $0.015 15 credits | |
| Official Google | |||
| 1K | 1 image | $0.036 36 credits | |
reApi를 선택해야 하는 이유
키 하나, 엔드포인트 하나, 2 개의 model ID
기본 Nano banana는 model에 `gemini-2.5-flash-image-preview`를, Google 공식 엔드포인트는 `gemini-2.5-flash-image-preview-official`을 보냅니다. 두 id 모두 동일한 `/api/v1/images/generations` 경로로 라우팅되며, 요청 본문의 문자열 하나만 바꾸면 전환됩니다. 두 번째 SDK도, 두 번째 키도, 별도 결제 시스템도 필요하지 않습니다. 코드 입장에서는 Nano banana도 다른 reApi 모델과 똑같이 동작합니다.
크레딧 입력, 이미지 출력 — 깜짝 비용 없음
가격은 정수 크레딧이며 1 크레딧은 0.001달러입니다. 페이지 내 견적기가 제출 전에 정확한 설정 비용을 계산해 주므로, 대시보드에 찍히는 Nano banana 청구액이 playground에서 본 금액과 일치합니다. 미터링 깜짝 비용도, 최소 약정도, 월 플랫폼 수수료도 없습니다 — 앱이 Nano banana로 실제 생성한 만큼만 이미지당 청구됩니다.
비동기 우선, 드롭인 호환
Nano banana 작업을 제출하면 즉시 task_id를 받고, 결과가 도착할 때까지 폴링하면 됩니다. 서버리스 함수, 큐 워커, 엣지 런타임 — 어디서 실행하든 비동기 패턴이 그대로 맞춰집니다. 실패하거나 검열로 차단된 요청은 과금되지 않으므로 불안정한 프롬프트가 크레딧을 소모하지 않습니다. 동일한 라이프사이클이 모든 reApi 모델에 적용되므로, Nano banana는 기존 작업 처리 파이프라인에 그대로 꽂힙니다.
Nano banana를 세 단계로 연동하기
- step 01
API 키 생성
reApi에 가입하고 대시보드에서 키를 받습니다. 무료 가입 크레딧이 처음 100회 이상의 Nano banana 생성을 커버하므로, 첫 기능을 출시하면서도 반복 작업 동안 청구액을 0으로 유지할 수 있습니다.
열기 - step 02
생성 작업 제출
model: gemini-2.5-flash-image-preview와 prompt를 담아 /api/v1/images/generations로 POST합니다. 필요에 따라 size, n, image_urls를 추가하세요 — 게이트웨이가 과금 전에 모든 필드를 검증합니다. Nano banana가 즉시 task_id를 반환하므로 요청이 핸들러를 차단하지 않습니다.
열기 - step 03
결과 폴링
status가 completed가 될 때까지 /api/v1/tasks/:id를 GET 합니다. Nano banana 응답에는 24시간 동안 안정적으로 접근 가능한 CDN 이미지 URL이 담깁니다. 더 오래 보관해야 하면 자체 스토리지로 복사하세요.
열기
자주 묻는 질문
이 모델에 대한 일반적인 질문입니다.
POST /api/v1/images/generations
Authorization: Bearer $REAPI_API_KEY
Content-Type: application/json
{
"prompt": "..."
}이제 출시할 준비가 되셨나요?
Playground에서 시험해 보거나 API 키를 발급받아 바로 연동해 보세요.