Seedance 2.5 is live — 30-second cinematic video with native audio & real-person references

Nano banana API — 단일 엔드포인트

Nano banana는 Google Gemini 2.5 Flash Image의 커뮤니티 별칭입니다. reApi의 OpenAI 호환 엔드포인트로 Nano banana 이미지를 생성·편집해 며칠이 아니라 몇 분 만에 프로덕션에 투입합니다.

모델 특징
1K · 10가지 종횡비 · 요청당 최대 4장
적합한 용도
빠른 초안, 썸네일, 반복
입력
텍스트 + 레퍼런스 이미지
출력
요청당 최대 4장
Input

자유 텍스트 · 필수 · ≤ 1000자

1:1부터 21:9까지 10가지 비율

Nano banana는 1K로만 렌더링

요청당 1–4장

0/16 files

최대 14장 · 공개 HTTPS URL만 허용

Result

Try one of these prompts

Gemini 2.5 Flash Image Preview API란?

Gemini 2.5 Flash Image Preview는 Google의 이미지 생성·편집 모델로, Nano Banana라는 이름으로 널리 알려져 있습니다. reAPI에서는 하나의 엔드포인트가 두 작업을 모두 처리합니다. 프롬프트만 보내면 텍스트-투-이미지, 참조 이미지를 최대 14장까지 보내면 편집과 합성이 됩니다. 화면비 10종과 1K 출력을 지원하고 요청당 1~4장을 반환합니다. 과금은 장당이며 Standard와 Official 중 어느 채널을 쓰느냐에 따라 단가가 달라집니다.

Nano banana 샘플 렌더

이 모델로 만들 수 있는 것

이 모델로 구축하고 배포할 수 있는 실제 워크플로우와 프로덕션 활용 사례입니다.

Nano banana로 생성한 상품 사진 리뉴얼

Nano banana로 상품 사진을 일괄 새 단장

재촬영 없이 기존 이커머스 사진을 편집합니다. 원본 URL을 image_urls에 넣고 변경 사항을 영어 자유 텍스트로 설명하면, Nano banana가 상품 형상은 그대로 두고 주변 장면만 다시 그려서 업데이트된 결과물을 반환합니다. 동일한 프롬프트 템플릿으로 SKU 100개를 돌려도 카탈로그 전체가 시각적으로 일관되게 유지됩니다 — 동일한 조명 언어, 동일한 배경 스타일, 모든 변형이 브랜드에 맞춰집니다.

사진 편집하기
Nano banana로 생성한 광고 크리에이티브 변형

광고 크리에이티브 초안을 몇 초 만에 생성

n=4로 단일 프롬프트에서 히어로 시안 4종을 만들어 스탠드업이 끝나기 전에 베스트 안을 고릅니다. 기본 Nano banana id는 속도와 저렴한 초안에 최적화돼 있고, 투자자 자료나 유료 광고에 더 높은 충실도가 필요할 때는 `gemini-2.5-flash-image-preview-official`로 전환합니다. 같은 엔드포인트, 같은 JSON 본문 — 초안과 최종본 사이에서 model id 한 줄만 바뀝니다.

Nano banana 기반 참고 이미지 합성

참고 이미지를 하나의 구도로 합성

최대 14장의 참고 이미지를 전달하고 어떻게 결합할지 설명하세요. Nano banana는 단일 호출에서 인물 + 배경 + 스타일 참고를 모두 처리합니다 — 상품 사진과 무드보드 한 장, 브랜드 컬러 팔레트 스와치를 함께 던지면 모델이 이를 새로운 온브랜드 컷으로 합성해 냅니다. 별도 mask 파일도, 별도 합성 단계도 필요 없습니다. 공개 HTTPS URL만 허용되므로 자체 R2 / S3 / OSS에 먼저 업로드하세요.

가격

크레딧 기반 — 1 크레딧 = 0.001 USD. 성공한 생성에 대해서만 비용을 지불합니다.

첫 테스트 비용
$0.01515 credits

최저 등급 1회 생성(1 image).

테스트 예산 가이드
크레딧 충전
$10
약 695회 테스트
$50
약 3478회 테스트
$100
약 6956회 테스트
모델카테고리가격
Default1K
$0.015
15 credits · 1 image
Official Google1K
$0.036
36 credits · 1 image

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를 세 단계로 연동하기

  1. step 01

    API 키 생성

    reApi에 가입하고 대시보드에서 키를 받습니다. 무료 가입 크레딧이 처음 100회 이상의 Nano banana 생성을 커버하므로, 첫 기능을 출시하면서도 반복 작업 동안 청구액을 0으로 유지할 수 있습니다.

    열기
  2. step 02

    생성 작업 제출

    model: gemini-2.5-flash-image-preview와 prompt를 담아 /api/v1/images/generations로 POST합니다. 필요에 따라 size, n, image_urls를 추가하세요 — 게이트웨이가 과금 전에 모든 필드를 검증합니다. Nano banana가 즉시 task_id를 반환하므로 요청이 핸들러를 차단하지 않습니다.

    열기
  3. step 03

    결과 폴링

    status가 completed가 될 때까지 /api/v1/tasks/:id를 GET 합니다. Nano banana 응답에는 24시간 동안 안정적으로 접근 가능한 CDN 이미지 URL이 담깁니다. 더 오래 보관해야 하면 자체 스토리지로 복사하세요.

    열기
docs/api/gemini-2-5-flash-image-preview

API 레퍼런스

바로 사용 가능한 코드와 전체 파라미터 표입니다.

전체 레퍼런스 보기
curl -X POST https://reapi.ai/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash-image-preview",
    "prompt": "moonlight on a bamboo path, ink wash painting",
    "size": "16:9"
  }'

파라미터 검증 실패

제출 시 동기적으로 거부되며 문제 필드가 명시됩니다. 열거 값·범위·URL 필드를 확인하세요. 과금은 발생하지 않습니다.

인증 또는 잔액 문제

401은 Bearer 키 누락/무효, 402는 선차감액이 잔액을 초과함을 뜻합니다. 키와 크레딧은 콘솔에서 관리합니다.

콘텐츠 또는 소재 거부

참조 소재와 생성 결과는 자동 심사를 거칩니다. 거부된 작업은 명확한 오류와 함께 실패하고 전액 환불됩니다.

작업 실패 또는 시간 초과

실패 상태에 도달한 작업은 과금되지 않으며 선차감액이 자동 환불됩니다. 작업 ID를 보관했다가 재시도하세요.

자주 묻는 질문

이 모델에 대한 일반적인 질문입니다.

Nano banana는 Google Gemini 2.5 Flash Image(공식 id: gemini-2.5-flash-image-preview)의 커뮤니티 별칭입니다. 1K 해상도로 렌더링하며 호출당 최대 14장의 참고 이미지를 받는 빠른 텍스트-투-이미지 및 이미지-투-이미지 모델입니다. reApi는 Nano banana를 OpenAI 호환 엔드포인트 하나와 크레딧 기반 과금으로 노출하므로, 평가 단계에서 사용한 동일한 기반 모델을 호출하면서도 상위 결제 시스템을 우회할 수 있습니다.

관련 모델

같은 카테고리의 다른 모델도 살펴보세요.

모든 모델 보기
start building

이제 출시할 준비가 되셨나요?

Playground에서 시험해 보거나 API 키를 발급받아 바로 연동해 보세요.

Nano banana 사용해 보기API 문서 보기