요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
aspect_ratio | 아니요 | 화면 모양: 가로, 정사각형, 세로. auto · 1:1 · 3:2 · 2:3 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9 · 1:4 · 4:1 · 1:8 · 8:1 · 기본값: auto |
enable_image_search | 아니요 | 장소나 제품의 실제 사진을 먼저 찾아봅니다. 기본값: false |
enable_web_search | 아니요 | 날짜, 장소, 최신 정보를 먼저 웹에서 확인합니다. 기본값: false |
image_urls | 예 | 편집하거나 합칠 사진. 각 사진의 역할을 프롬프트에 적어 주세요. |
output_format | 아니요 | 결과 파일 형식. png · jpeg · 기본값: png |
prompt | 예 | Say what to change and what must stay the same. |
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. 1k · 2k · 4k · 기본값: 1k |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| resolution 1K | 7.2 | US$0.072 |
| resolution 2K | 10.8 | US$0.11 |
| resolution 4K | 24.3 | US$0.24 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 8크레딧/장(US$0.08)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Nano Banana 2.1 API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 google/nano-banana-2.1/edit, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-2.1/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "auto",
"resolution": "1k",
"output_format": "png"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
Nano Banana 2.1 API 질문
Nano Banana 2.1 API 요금은 얼마인가요?
Nano Banana 2.1 가격은 가장 저렴한 이미지 편집 기준 8크레딧(US$0.08) /장부터입니다. 옵션별 가격: 1K 7.2크레딧/장, 2K 10.8크레딧/장, 4K 24.3크레딧/장. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Nano Banana 2.1의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 이미지 만들기: google/nano-banana-2.1/text-to-image; 이미지 편집: google/nano-banana-2.1/edit을(를) 넣으세요.
정말 Google의 Nano Banana 2.1인가요?
네. 요청은 Google이 2026년 10월 6일 Nano Banana 2.1로 공개한 모델, 즉 Nano Banana 2(Gemini 3.1 Flash Image)의 업데이트에서 처리됩니다. 1K, 2K, 4K 출력은 Google이 이 모델에 대해 공개한 크기와 일치합니다.
Nano Banana 2.1과 Nano Banana 2 중 무엇을 써야 하나요?
더 새로운 쪽은 2.1입니다. Google이 화질, 프롬프트 충실도, 캐릭터 일관성, 텍스트 렌더링을 개선하고 2K와 4K 넓은 배너의 이음새를 없앴다고 밝혔습니다. Nano Banana 2에는 2.1에 없는 0.5K 초안 단계가 있습니다. 둘 다 웹 검색과 이미지 검색, 최대 14장의 참고 이미지를 지원합니다. Google은 Nano Banana 2를 지원 중단 예정으로 분류했으며(종료일은 발표되지 않았습니다) 2.1로 옮기기를 권장합니다.
텍스트는 얼마나 잘 그려지나요?
따옴표로 묶은 줄은 모두 적은 그대로의 철자로 나왔습니다. 잡지 제호와 커버 문구 두 줄, 영화 제목과 개봉 문구, 모텔 네온사인, 편집에서 빈 슬리브에 디자인한 앨범 제목입니다. 포스터 제목 아래의 잔글씨나 바코드처럼 철자를 적지 않은 작은 글씨는 의미 없는 채움 글자로 나왔습니다.
이미지 크기는 어떻게 되나요?
1:1에서 각 단계는 한 변 1024, 2048, 4096픽셀입니다. 다른 비율도 화소 수는 거의 비슷합니다. 저희 테스트에서 1k의 3:4는 896 × 1200, 2k의 16:9는 2752 × 1536, 2k의 8:1 배너는 5856 × 704로 돌아왔습니다.
Nano Banana 2.1 API의 제한은 무엇인가요?
해상도: 1K · 2K · 4K; 화면 비율: auto · 1:1 · 3:2 · 2:3 · 3:4 · 4:3 +9; 참조 이미지: 14; 프롬프트 길이(글자): 5,000; 최대 업로드 크기: 10 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Nano Banana 2.1을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Nano Banana 2.1을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 Nano Banana 모델
Nano Banana Pro는 그리기 전에 레이아웃부터 계획해서, 글자가 빽빽한 디자인이나 도표, 여러 부분으로 된 구성을 더 꼼꼼하게 처리해요. Nano Banana 2.1은 더 새롭고 빠르며 한 장당 가격이 절반도 안 되고, 8:1 배너와 웹·이미지 검색도 지원해요.

