Nano Banana API
AI 이미지Nano Banana API는 Google의 원조 Gemini 2.5 Flash Image 경로로, OmniaKey 미디어 API에서 텍스트 이미지 생성과 참조 편집을 지원합니다.
- 성공한 호출당$0.019
- 작업텍스트를 이미지로
- 이미지 편집
- 도구 요금 및 과금 기준 보기
모델을 실행하면 결과가 여기에 표시됩니다.
01
어울리는 용도
Nano Banana API는 Google의 원조 Gemini 2.5 Flash Image 경로로, OmniaKey 미디어 API에서 텍스트 이미지 생성과 참조 편집을 지원합니다.
기존 Gemini 2.5 이미지 작업에는 Nano Banana를 사용할 수 있습니다. Nano Banana 2는 1K 요금이 같으며 더 큰 출력도 지원합니다.
02
할 수 있는 일
텍스트를 이미지로
gemini-2.5-flash-image
텍스트 프롬프트로 새 이미지를 만듭니다.
이미지 편집
gemini-2.5-flash-image
프롬프트와 참조 입력으로 기존 이미지를 수정합니다.
03
자세히 보기
Nano Banana는 OmniaKey에서 제공되는 구글의 원조 Gemini 2.5 Flash Image 모델이며, 모델 ID는 gemini-2.5-flash-image이고 텍스트-투-이미지와 이미지 편집을 지원합니다. Nano Banana는 Gemini의 네이티브 이미지 생성 및 편집 기능을 가리키는 구글의 제품명으로, 여기서는 해당 계열 중 가장 오래된 모델입니다. 요금표에는 호출당 단일 요금이 책정되어 있으며 크기 구간도, 함께 제공되는 프리뷰 별칭도 없습니다.
이 모델이 실무에서 가장 유용하게 쓰인 부분은 비교 우위를 가리는 것과는 무관했습니다. 다른 모델이 이후에 편집할 원본 사진을 만드는 데 사용했기 때문에 어떤 모델도 자기 결과물을 평가하지 않았고, 중립적인 프레임은 바로 레거시 모델이 잘하는 작업입니다. 또한 기존 Gemini 2.5 코드가 이미 호출하고 있는 모델 ID이기도 합니다.
두 가지 한계가 선택에 영향을 줍니다. 요금표에 이 모델 ID의 2K 또는 4K 단계가 없으므로 큰 결과물이 필요하면 다른 모델을 써야 하고, 구글이 이후에 내놓은 텍스트 렌더링, 레퍼런스, 멀티턴 편집 개선은 최신 모델 ID에 적용됩니다. 이 모델은 연속성과 원본 소재 용도로 유지하고, 새 작업은 Nano Banana 2.1이나 Pro로 시작하시기 바랍니다.
편집 테스트용 중립 프레임
여러 모델이 같은 사진을 편집해야 할 때는 그 사진을 이 모델로 만드십시오. 10월에 진행한 6개 테스트 라운드가 정확히 그렇게 했기 때문에 어떤 모델도 자기 결과물을 개선하도록 요청받지 않았고 비교가 공정하게 유지되었습니다. 원본은 단순하게 유지하고 조명과 구도는 한 번만 정한 뒤 같은 파일을 모든 곳에서 재사용하십시오.
기존 Gemini 2.5 코드
2.5 세대를 기준으로 작성된 클라이언트는 다시 작성하지 않아도 계속 작동합니다. 작업 형태도, 편집 동작도 같고 호출당 요금도 하나입니다. 모델 ID는 코드에 직접 넣지 말고 설정에서 고정하십시오. 그러면 나중에 gemini-nano-banana-2.1로 옮길 때 설정 변경과 샘플 세트 재실행만 하면 됩니다.
단순한 제품 및 라이프스타일 프레임
간단한 작업은 여전히 쓸 만한 결과가 나옵니다. 물체 하나, 주광, 깨끗한 배경, 빽빽한 텍스트 없음이 조건입니다. 포스터, 가격표, 또는 얼굴을 알아볼 수 있어야 하는 여러 사람이 나오는 작업에는 이 모델을 쓰지 말고, 억지로 맞추지 말고 최신 모델에 맡기십시오.
04
미리 알아야 할 제한
- 요금표에는 이 모델 ID에 대해 호출당 단일 요금만 있고 크기 구간이 없으므로 2K나 4K 캔버스를 가정하지 말고 실제로 받은 이미지 크기를 확인하십시오.
- 여기서는 해당 계열 중 가장 오래된 모델입니다. 구글이 이후에 내놓은 텍스트, 레퍼런스, 멀티턴 관련 개선은 이 모델이 아니라 최신 모델 ID에 속합니다.
- 구글에 따르면 생성된 이미지에는 SynthID 워터마크가 들어갑니다. 이는 출처를 표시하는 것이며 사진이 정확한지와는 무관합니다.
- 편집 시 원본은 1 MiB 본문 안에 인라인으로 전달되므로, 카메라로 찍은 원본 크기 파일은 작업을 만들기 전에 크기를 줄여야 합니다.
05
인접 모델 비교
| 모델 | 다음에 가장 적합 | 작업 | 표시 가격 |
|---|---|---|---|
| Nano Banana이 페이지 gemini-2.5-flash-image | 기존 2.5 워크플로와 중립 원본 프레임에 적합하며, 호출당 요금은 요금표에 하나로 책정되어 있습니다. | 텍스트를 이미지로 · 이미지 편집 | $0.019 호출당 |
| Nano Banana 2.1 gemini-nano-banana-2.1 | 정확한 글자, 레퍼런스 이미지 열 개, 1K에서 4K까지의 출력이 필요한 새 작업에 적합합니다. | 텍스트를 이미지로 · 이미지 편집 | $0.019–$0.039 호출당 |
| Nano Banana Pro gemini-3-pro-image | 복잡한 레이아웃과 인물 편집에서 요금표상 최상위 등급이 물리적 디테일을 확보해 주는 작업에 적합합니다. | 텍스트를 이미지로 · 이미지 편집 | $0.039–$0.069 호출당 |
06
출처와 검증
가이드 업데이트: 2026-10-27.
07
호출 방법
미디어 모델은 비동기로 동작합니다. 작업을 만들고 완료될 때까지 폴링한 뒤 서명된 에셋 URL을 내려받으세요.
# 1. Create the job. 202 Accepted; the body carries the task id,
# the pre-charged price, and a poll_url. Reuse one Idempotency-Key
# across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
-H "Authorization: Bearer $OMNIAKEY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: gemini-2.5-flash-image-001" \
-d '{
"model": "gemini-2.5-flash-image",
"type": "image",
"operation": "generate",
"input": {"prompt": "a paper boat on a quiet lake at sunset"},
"parameters": {"aspect_ratio": "1:1"}
}'
# 2. Poll GET /v1/media/tasks/{id} until status is
# succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
-H "Authorization: Bearer $OMNIAKEY_API_KEY"
# 3. Download assets[0].url before expires_at, or poll again for a
# fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.png "$(jq -r '.assets[0].url' result.json)"08
가격
이미지 작업은 토큰이 아니라 성공한 호출당 과금됩니다. 실패하거나 취소된 작업은 자동으로 환불됩니다.
$0.019호출당51% 절약
더 많은 Google 이미지 모델
관련 글
Nano Banana 제품 사진: 프롬프트 8개 실측
프롬프트 8개, 편집 22회, 모델 2개. 라벨 글자가 살아남은 사진, 신발이 어디서 좌우 반전됐는지, 작업별로 어떤 모델을 고를지 정리했습니다.
글 읽기Gemini 이미지 생성 API 프록시 연결 가이드
API 형식을 선택하고 이미지를 생성한 뒤, 시간 초과가 발생한 작업을 안전하게 이어갑니다.
글 읽기GPT Image 2.5 vs Nano Banana 2.1: 같은 프롬프트로 비교한 결과와 가격
프롬프트 네 개, 이미지 모델 세 개, 같은 날. 각자 무엇을 만들었고 실제로 얼마가 나왔는지 정리했습니다.
글 읽기Qwen Image 3 vs Nano Banana 2.1: 같은 프롬프트 비교 테스트와 가격
프롬프트 4개, 이미지 모델 2개, 같은 날. 무엇이 나왔고 얼마가 들었는지.
글 읽기자주 묻는 질문
OmniaKey에서 Nano Banana을(를) 어떻게 호출하나요?
모델 id, type "image", operation "generate" 또는 "edit"와 함께 /v1/media/tasks로 POST하세요. 재시도 시 같은 Idempotency-Key를 쓰면 타임아웃으로 두 번째 유료 작업이 생기지 않습니다.
Nano Banana 비용은 얼마인가요?
Nano Banana은(는) $0.019 호출당로 과금됩니다. 생성 시 선불 잔액에서 미리 차감되며, 실패하거나 취소된 작업은 자동으로 환불됩니다.
왜 API가 이미지 대신 작업 id를 반환하나요?
공급자 지연이 수초에서 1분 정도까지 달라지므로 OmniaKey는 모든 이미지 경로를 하나의 비동기 흐름으로 통일합니다. 상태가 succeeded가 될 때까지 GET /v1/media/tasks/{id}를 폴링한 뒤 서명된 에셋 URL을 읽으세요.
Nano Banana는 Nano Banana 2와 같은 모델입니까?
아닙니다. Nano Banana는 Gemini의 네이티브 이미지 생성을 가리키는 구글의 제품명이며, 이 모델 ID gemini-2.5-flash-image는 플랫폼에서 해당 계열 중 가장 오래된 모델입니다. Nano Banana 2는 gemini-3.1-flash-image를, Nano Banana 2.1은 gemini-nano-banana-2.1을 사용하며 각각 동작이 다른 별개 모델입니다.
이 모델로 4K 이미지를 만들 수 있습니까?
요금표에 이 모델 ID의 크기 단계가 없으므로 직접 고르는 캔버스가 아니라 모델이 반환하는 크기를 기준으로 계획하십시오. 4K 파일이 목표라면 Nano Banana 2와 2.1 모두 1K에서 4K까지 제공하며, Pro는 그 위에 자체적인 더 높은 상위 등급을 추가합니다.
이 모델의 요금은 어떻게 계산됩니까?
호출당 이미지 한 장에 단일 요금이 적용되고 선택할 크기 단계가 없으므로 같은 작업을 반복해도 매번 같은 요금이 나옵니다. 현재 요금은 모델 페이지의 요금표에 있습니다. 실패한 작업은 예약된 크레딧이 반환되며, 만료된 자산 링크는 같은 작업을 다시 폴링하여 갱신할 수 있습니다.
왜 오래된 이미지 모델을 계속 유지합니까?
연속성과 원본 소재 때문입니다. 이미 검토를 통과한 프롬프트는 계속 작동하며, 편집 비교용 중립 프레임에는 가장 강력한 모델이 필요하지 않습니다. 빽빽한 텍스트, 여러 레퍼런스, 큰 캔버스가 필요한 새 작업은 최신 모델 ID에 맡기십시오.
이 모델은 이미지에 워터마크를 추가합니까?
구글에 따르면 생성된 이미지에는 SynthID 워터마크가 포함되며, 이 모델도 그 계열에 속합니다. 이 표시는 눈에 보이는 로고가 아니라 출처 메타데이터이며, 라벨이나 개수, 얼굴이 제대로 나왔는지와는 무관합니다.
