
생성된 이미지 링크는 작업 완료 후 72시간 뒤 만료됩니다. 이미지를 제때 다운로드하세요.
숨겨진 수수료 없는 투명한 요금제. 사용한 만큼만 지불하세요.
* 실제 비용은 최종 출력에 따라 달라집니다.
* gemini-nano-banana-2.1: 이미지 출력 비용만 예상합니다. 입력과 추론 비용은 별도이며 최종 요금은 실제 사용량에 따라 결정됩니다.
* Ext를 사용할 수 없을 때 공식 버전으로 전환하도록 허용합니다. 전환된 작업은 공식 토큰 요금이 적용되므로 최종 요금이 Ext 예상 요금과 다를 수 있습니다.
Gemini Nano Banana 2.1은 Google이 Nano Banana 2를 업데이트한 모델로, 화질, 프롬프트 충실도, 캐릭터 일관성, 텍스트 렌더링이 향상되었습니다. 프롬프트와 참조 이미지로 14가지 화면비의 1K, 2K, 4K 이미지를 만들고, 작업에 맞게 공식 경로 또는 Ext를 선택하세요.
Nano Banana 2.1이 지원하는 입력, 출력 설정, 작업 흐름
크리에이티브, 커머스, 콘텐츠 팀을 위한 Nano Banana 2.1 활용 아이디어
APIMart에서 POST 요청 한 번으로 Google Nano Banana 2.1을 호출하세요. Nano Banana 2.1 생성은 비동기입니다. 작업을 제출한 뒤 작업 엔드포인트를 폴링해 이미지 URL을 받으세요.
APIMart API 키를 환경 변수 APIMART_API_KEY에 저장하고, 모든 요청에 Authorization: Bearer <key>로 전달하세요.
POST /v1/images/generations에 Nano Banana 2.1 모델, 프롬프트, size, resolution을 지정하세요. 이미지를 편집하려면 image_urls를 추가하세요. 응답으로 task_id가 반환됩니다.
작업이 완료될 때까지 GET /v1/tasks/{task_id}를 보낸 뒤 data.result.images[0].url 배열에서 이미지 URL을 읽으세요(n이 4이면 링크 4개가 들어 있습니다). expires_at에 링크가 만료되기 전에 파일을 저장하세요. 실패한 작업은 전액 환불되며 이유는 error.message에 반환됩니다.
전체 파라미터와 응답 필드는 Nano Banana 2.1 API 문서에서 확인하세요.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-nano-banana-2.1",
"prompt": "A panoramic website banner of a mountain lake at sunrise with the headline Explore More in clean white type",
"n": 1,
"size": "16:9",
"resolution": "2K"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "gemini-nano-banana-2.1",
"prompt": "A panoramic website banner of a mountain lake at sunrise with the headline Explore More in clean white type",
"n": 1,
"size": "16:9",
"resolution": "2K"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-nano-banana-2.1",
"prompt": "Place the product from this photo on a marble kitchen counter in soft morning light and keep the label unchanged",
"n": 1,
"size": "1:1",
"resolution": "2K",
"image_urls": [
"https://example.com/product.jpg"
]
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | 필수 | 기본값: gemini-nano-banana-2.1 | gemini-nano-banana-2.1(공식, 1~4장, 토큰 과금) 또는 gemini-nano-banana-2.1-ext(Ext, 1장, 장당 과금). |
prompt | string | 필수 | 기본값: — | 생성할 이미지 또는 수행할 편집에 대한 설명. |
size | string | 선택 | 기본값: auto | auto 또는 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1. 두 경로 모두 모든 비율을 지원합니다. |
resolution | string | 선택 | 기본값: 1K | 1K, 2K 또는 4K이며 요금에 영향을 줍니다. 0.5K는 지원하지 않습니다. |
n | integer | 선택 | 기본값: 1 | 공식 경로: 1~4. Ext 경로: 1만 가능. |
image_urls | array | 선택 | 기본값: — | 공개 HTTP(S) URL 또는 base64 Data URL 형식의 참조 이미지. PNG, JPEG, WEBP 권장. 텍스트로 이미지를 생성할 때는 비워 두세요. |
official_fallback | boolean | 선택 | 기본값: false | Ext 전용. Ext 경로가 실패해 공식 경로로 완료되면 공식 토큰 요금이 적용됩니다. |
webhook | string | 선택 | 기본값: — | 작업 종료 시 호출되는 콜백 URL. |
APIMart의 모든 Nano Banana 모델을 비교하세요. API 키 하나로 전체 모델을 호출하며 이미지당 과금됩니다.
| 모델 | 기반 모델 | 추천 용도 | 해상도 |
|---|---|---|---|
| Nano Banana API | Gemini 2.5 Flash Image | 캐릭터 일관성, 다중 이미지 합성, 프롬프트 기반 편집 | 1K |
| Nano Banana Pro API | Gemini 3 Pro Image | 전문가급 4K 이미지, 선명한 다국어 텍스트, 최대 5명 일관성 | 1K / 2K / 4K |
| Nano Banana 2 API | Gemini 3.1 Flash Image | 0.5K~4K의 빠르고 비용 효율적인 생성 | 0.5K – 4K |
| Nano Banana 2 Lite API | Gemini 3.1 Flash Lite Image | 빠른 1K 이미지 생성과 편집, 요청당 1장, 참조 이미지 최대 14장 | 1K |
| Gemini Nano Banana 2.1 API현재 페이지 | Gemini Nano Banana 2.1 | 최신 버전: 텍스트-이미지 생성과 참조 이미지 편집, 14가지 비율 지원 | 1K / 2K / 4K |
Nano Banana 2.1의 경로, 파라미터, 요금, 결과 처리
Gemini Nano Banana 2.1은 Google의 최신 고효율 이미지 생성·편집 모델이며 Nano Banana 2(Gemini 3.1 Flash Image)의 업데이트 버전입니다. Flash 수준의 속도와 비용 효율을 유지하면서 화질, 프롬프트 충실도, 멀티턴 캐릭터 일관성, 텍스트 렌더링을 개선했습니다. APIMart에서는 Nano Banana 2.1 API로, model gemini-nano-banana-2.1을 지정해 호출할 수 있습니다.
Google은 2026년 10월 6일 Gemini Nano Banana 2.1을 정식 출시(GA)했습니다. Google이 지원 중단한 gemini-3.1-flash-image를 대체하며, Google은 Nano Banana 2.1로의 이전을 권장합니다.
Google은 Nano Banana 2.1을 Nano Banana 2의 업데이트 버전으로 소개하며, 화질, 프롬프트 충실도, 멀티턴 캐릭터 일관성, 텍스트 렌더링, 그리고 1K·2K·4K에서의 초가로형·파노라마 비율(1:4, 4:1, 1:8, 8:1)이 크게 향상되었습니다. Nano Banana 2.1은 0.5K를 지원하지 않습니다.
gemini-nano-banana-2.1은 Google 공식 경로를, gemini-nano-banana-2.1-ext는 Ext 경로를 사용합니다. 둘 다 같은 Nano Banana 2.1 모델을 실행하며 지원 해상도와 화면 비율도 같습니다. 요금 체계, 이미지 수, 참조 이미지 크기 제한은 다릅니다.
공식 경로는 n을 1~4로 설정할 수 있습니다. Ext는 현재 n=1만 지원합니다. 여러 장이 필요하면 Ext 작업을 따로 제출하거나 공식 경로를 사용하세요.
image_urls는 공개 접근 가능한 HTTP(S) URL 또는 base64 이미지 데이터를 받습니다. PNG, JPEG, WEBP를 권장합니다. 공식 경로는 장당 20 MB 이하, Ext는 장당 30 MB 이하이면서 총 50 MB 이하입니다. 플랫폼이 참조 개수를 제한하지는 않지만 상위 공급자의 제한은 적용됩니다.
1K, 2K, 4K와 auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1을 지원합니다. 공식 경로와 Ext 모두 모든 해상도에서 이 비율을 지원하며, 1:4, 4:1, 1:8, 8:1도 2K와 4K에서 사용할 수 있습니다. 기본값은 1K와 auto입니다. 0.5K는 지원하지 않습니다.
공식 경로는 이미지 출력과 추론을 포함한 실제 입력 및 출력 토큰으로 과금됩니다. 이미지 출력 예상 비용은 작업 전체 비용이 아닙니다. Ext는 해상도에 따른 장당 요금이므로 Nano Banana 2.1 가격은 선택한 경로와 해상도에 따라 달라집니다. 플랫폼 요금표를 참고하고, 완료된 작업의 cost에서 최종 금액을 확인하세요.
Ext의 선택 설정이며 기본적으로 꺼져 있습니다. 타사 경로가 실패하여 공식 경로로 작업을 완료하면 Ext의 장당 요금 대신 공식 토큰 요금이 적용됩니다.
POST /v1/images/generations에서 task_id를 받은 뒤 GET /v1/tasks/{task_id}로 완료 또는 실패까지 조회합니다. 완성된 이미지 링크는 data.result.images[0].url 배열에 있습니다. n이 4이면 이 배열에 링크 4개가 들어 있습니다.
이미지 링크는 완료 72시간 후 만료됩니다. expires_at을 확인하고 파일을 제때 저장하세요. 상태가 failed인 작업은 전액 환불되며 cost=0으로 표시됩니다. 상태 조회 중의 네트워크 오류만으로 생성 실패를 의미하지는 않습니다.
APIMart에 가입한 뒤 대시보드의 API 키 페이지에서 Nano Banana 2.1 API 키를 생성하세요. 같은 키로 Google Nano Banana 2.1 API와 플랫폼의 다른 모든 모델을 호출할 수 있으며, 종량제로 구독이 필요 없습니다.
같은 카테고리의 다른 모델을 탐색하세요.

Seedream 5.0 Flash
Seedream 5.0 Flash is ByteDance's fast, lower-cost text-to-image model. It supports single-image and multi-reference editing with up to 10 references and generates 1K, 1.5K or 2K images, or exact pixel sizes, with strong text rendering.

GPT Image 2.5 Flare
GPT Image 2.5 Flare is OpenAI's speed-focused GPT Image 2.5 model for image generation and editing. It supports up to 16 reference images, inpainting with transparent PNG masks and 15 aspect ratios.

GPT Image 2.5 Sunburst
GPT Image 2.5 Sunburst is an OpenAI image model for generation and editing, focused on precise edits for detail-sensitive creative work. Supports up to 16 reference images and PNG, JPEG or WebP output.

Grok Imagine Image Quality
Grok Imagine Image Quality is the quality-focused version of xAI's Grok image model for photorealistic text-to-image and image editing, with up to three reference images.