Nano Banana 2.1 API
Google의 Gemini 3.6 Flash 기반 이미지 생성·편집 모델로, 마스크 기반 편집과 다중 턴 대화형 워크플로를 지원합니다.
Nano Banana 2.1은 Gemini 3 시리즈에 속하는 Google의 이미지 생성 및 편집 모델로, Gemini 3.6 Flash를 기반으로 합니다. 마스크로 지정한 영역만 변경하면서 주변 구도를 유지하는 편집, 장면과 조명, 각도가 달라져도 얼굴과 정체성을 일관되게 유지하는 기능, 프롬프트당 최대 14장의 참조 이미지 활용을 지원합니다. 최대 4명의 인물과 10개의 객체에 대한 정체성 일관성도 유지합니다.
1K, 2K, 4K 이미지 해상도를 지원하며 기본값은 1K입니다. 1:1, 3:2, 2:3, 3:4, 1:4, 4:1, 4:3, 4:5, 5:4, 1:8, 8:1, 9:16, 16:9, 21:9 비율을 지원하고, 2K와 4K에서 와이드·파노라마 비율의 타일링 아티팩트를 수정했습니다. 입력 이미지는 장당 1,120 토큰을 소비하고 출력 이미지 토큰은 1K에서 1,120, 2K에서 1,680, 4K에서 3,780입니다.
전문가 수준의 정밀한 이미지 제작과 편집, 여러 차례에 걸친 빠른 반복 편집, 포스터와 복잡한 다이어그램의 선명한 텍스트 생성, 다국어 국소 텍스트 렌더링, 스토리텔링과 반복 워크플로를 위한 다중 턴 대화형 편집에 적합합니다. 제품 장면과 다인물 장면, 시리즈 자산을 위한 다중 이미지 융합, 가상 피팅과 캐릭터 생성에도 활용할 수 있습니다.
업데이트:
모델 ID
gemini-nano-banana-2.1- 컨텍스트
- 65.536K
- 최대 출력
- 58.982K
- 입력
- image / text
- 출력
- image / text
주요 특징
- Gemini 3.6 Flash 기반 이미지 생성·편집
- 마스크 영역만 바꾸는 정밀 편집
- 장면·조명·각도가 달라도 인물 일관성 유지
- 프롬프트당 최대 14장 참조 이미지
- 최대 4명 인물·10개 객체 정체성 유지
- 1K·2K·4K 해상도 지원
제공 업체
제공 업체별 API 요금을 비교하세요. 공급자를 선택하면 전체 요금과 적용 조건을 확인할 수 있습니다.
| 가동률 | |
|---|---|
과거 통계는 실시간 상태 확인이 아닙니다. 데이터 누락이 장애를 뜻하지는 않습니다.
추론
- 기본 추론 강도
- minimal
- 기본 활성화
- 예
- 항상 활성화
- 아니요
- 선택 가능한 추론 강도
- high / minimal / none
Quick Start
이미지 작업을 제출하고 상태를 조회한 뒤 이미지를 저장합니다. curl과 Python 3 표준 라이브러리만 사용합니다.
POST https://openapi.felo.ai/api/v1/images/generations
1API key 설정
Felo API Platform 계정에서 key를 만들고 환경 변수로 설정하세요.
export FELO_API_KEY="YOUR_API_KEY"2첫 요청 보내기
선택 매개변수 값은 모델마다 달라 예제에서는 지정하지 않습니다. 추가 전에 Playground에서 확인하세요. 필드는 input 안이 아닌 model, prompt와 같은 수준에 둡니다.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
"model": "gemini-nano-banana-2.1"
}'3작업 폴링
제출 후 task_id가 반환됩니다. queued 또는 running이면 3초마다 조회하고 succeeded, failed, interrupted이면 멈춥니다. 최대 30분 대기합니다. created.json을 보관하면 재제출 없이 같은 작업을 계속 조회할 수 있습니다.
python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen
task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800
while task["status"] in ("queued", "running"):
if time.monotonic() >= deadline:
raise TimeoutError(f"Keep task_id={task_id} to resume polling")
time.sleep(3)
with urlopen(Request(url, headers=headers), timeout=60) as response:
task = json.load(response)
if task.get("task_id") != task_id or task.get("kind") != "image":
raise ValueError("Unexpected task response")
print(task["status"])
if task["status"] != "succeeded":
raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY4출력 다운로드
성공하면 task.json의 outputs를 저장합니다. HTTPS URL, URL 객체, b64_json을 지원합니다. 서명 URL은 즉시 다운로드하세요. 이미지 다운로드에는 API Key가 필요하지 않습니다.
python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen
task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}
for index, output in enumerate(task["outputs"], 1):
item = output if isinstance(output, dict) else {}
url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
mime = item.get("media_type") or "image/png"
if url and url.startswith("https://"):
with urlopen(url, timeout=60) as response:
data = response.read()
mime = response.headers.get_content_type()
elif url and url.startswith("data:image/") and ";base64," in url:
header, encoded = url.split(",", 1)
mime = header[5:].split(";", 1)[0]
data = base64.b64decode(encoded, validate=True)
elif item.get("b64_json"):
data = base64.b64decode(item["b64_json"], validate=True)
else:
raise ValueError("Unrecognized image output")
path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
path.write_bytes(data)
print(path)
PYinput_references
이미지 편집 시 예제 URL을 본인의 HTTPS 이미지 URL 또는 base64 이미지 data URL로 바꾸세요. 한 번 제출한 후 동일한 조회 및 저장 단계를 따릅니다.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
"model": "gemini-nano-banana-2.1",
"input_references": [
{
"type": "image_url",
"image_url": {
"url": "https://example.com/product.png"
}
}
]
}'지원 매개변수
- n
- seed
- tools
- top_p
- reasoning
- max_tokens
- resolution
- temperature
- tool_choice
- aspect_ratio
- response_format
- input_references
- reasoning_effort
- include_reasoning
- structured_outputs
전체 레퍼런스가 필요하신가요?
API 문서 →자주 묻는 질문
모델 소개: Nano Banana 2.1?
Nano Banana 2.1은 Gemini 3 시리즈에 속하는 Google의 이미지 생성 및 편집 모델로, Gemini 3.6 Flash를 기반으로 합니다. 마스크로 지정한 영역만 변경하면서 주변 구도를 유지하는 편집, 장면과 조명, 각도가 달라져도 얼굴과 정체성을 일관되게 유지하는 기능, 프롬프트당 최대 14장의 참조 이미지 활용을 지원합니다. 최대 4명의 인물과 10개의 객체에 대한 정체성 일관성도 유지합니다. 1K, 2K, 4K 이미지 해상도를 지원하며 기본값은 1K입니다. 1:1, 3:2, 2:3, 3:4, 1:4, 4:1, 4:3, 4:5, 5:4, 1:8, 8:1, 9:16, 16:9, 21:9 비율을 지원하고, 2K와 4K에서 와이드·파노라마 비율의 타일링 아티팩트를 수정했습니다. 입력 이미지는 장당 1,120 토큰을 소비하고 출력 이미지 토큰은 1K에서 1,120, 2K에서 1,680, 4K에서 3,780입니다. 전문가 수준의 정밀한 이미지 제작과 편집, 여러 차례에 걸친 빠른 반복 편집, 포스터와 복잡한 다이어그램의 선명한 텍스트 생성, 다국어 국소 텍스트 렌더링, 스토리텔링과 반복 워크플로를 위한 다중 턴 대화형 편집에 적합합니다. 제품 장면과 다인물 장면, 시리즈 자산을 위한 다중 이미지 융합, 가상 피팅과 캐릭터 생성에도 활용할 수 있습니다.
사용 요금은 어떻게 계산되나요?
이용하는 제공 업체의 요금과 실제 사용량에 따라 비용이 결정됩니다. 긴 입력 등에는 다른 요금이 적용될 수 있습니다. 실제 생성 비용을 기준으로 과금됩니다. 최종 금액은 청구 내역을 확인하세요.
Nano Banana 2.1은 어떤 입력을 지원하나요?
텍스트, 이미지, 비디오, PDF 입력을 지원하며 이미지와 텍스트 출력을 생성합니다. 비디오 입력에서 이미지를 생성할 수도 있습니다.
컨텍스트와 출력 길이는 얼마인가요?
컨텍스트는 131,072, 출력 한도는 32,768입니다.
어떤 작업에 가장 적합한가요?
전문가 수준의 이미지 제작과 편집, 여러 차례의 반복 편집, 포스터와 복잡한 다이어그램의 선명한 텍스트 생성에 적합합니다. 다중 턴 대화형 편집과 다중 이미지 융합, 가상 피팅에도 활용할 수 있습니다.
동일 시리즈 모델과 어떻게 다른가요?
Nano Banana 2.1은 Gemini 3.1 Flash Image 기반의 Nano Banana 2를 업그레이드한 모델입니다. Gemini 3 Pro Image(Nano Banana Pro)에 준하는 품질을 제공하는 고효율 대안으로 자리매김합니다.
이미지 해상도와 비율은 어떻게 되나요?
1K, 2K, 4K 해상도를 지원하며 기본값은 1K입니다. 1:1, 3:2, 2:3, 3:4, 1:4, 4:1, 4:3, 4:5, 5:4, 1:8, 8:1, 9:16, 16:9, 21:9 비율을 지원합니다.
지원하지 않는 기능이 있나요?
temperature, topP, topK, seed, logprobs 파라미터를 지원하지 않으며 설정 시 API 오류가 반환됩니다. 오디오 생성, 캐싱, 코드 실행, 파일 검색, 함수 호출, 구조화된 출력도 지원하지 않습니다.
관련 모델
Nano Banana 2 Lite (Gemini 3.1 Flash Lite Image)
Google이미지gemini-3.1-flash-lite-image구글의 가장 빠르고 효율적인 1K 이미지 생성 모델로, 4초 만에 텍스트를 이미지로 만들 수 있습니다.
출력
image / text
컨텍스트
65.536K
입력 토큰
$0.25 / 1M 토큰
출력 토큰
$1.5 / 1M 토큰
Nano Banana Pro (Gemini 3 Pro Image)
Google이미지gemini-3-pro-imageGoogle의 플래그십 이미지 생성·편집 모델로, 최대 4K 해상도와 뛰어난 텍스트 렌더링, 전문가급 제어 기능을 제공합니다.
출력
image / text
컨텍스트
131.072K
입력 토큰
$2 / 1M 토큰
출력 토큰
$12 / 1M 토큰