소개
Nano Banana 2 텍스트→이미지는 2026년 2월 26일에 공개된 Google의 Gemini 3.1 Flash Image로, 글로 쓴 프롬프트에서 이미지를 생성합니다. Google은 이 모델을 Flash의 속도로 Pro급 화질을 내는 모델로 소개합니다. 0.5k부터 4k까지 네 단계 크기, 8:1까지 14가지 비율로 렌더링하고 그리기 전에 웹과 참고 이미지를 검색할 수 있으며, 요금은 Google 정가보다 훨씬 낮은 가격부터 시작합니다.
가진 소재에 맞춰 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 글로 쓴 브리프 | Nano Banana 2 텍스트→이미지 |
| 바꾸고 싶은 이미지 | Nano Banana 2 이미지 편집 |
핵심 기능 및 하이라이트
이코노미 경로와 Official fallback
요청은 먼저 Google 정가보다 훨씬 낮은 가격의 이코노미 경로에서 실행됩니다. Official fallback(기본값은 켜짐)이 켜져 있으면 거기서 완료하지 못한 요청은 공식 경로에서 공식 가격으로 다시 실행됩니다. 어느 쪽이든 모델은 Google의 Gemini 3.1 Flash Image이며, 크기 단계는 Google이 Nano Banana 2에 대해 공개한 값과 같습니다.
네 단계 크기, 14가지 비율
512픽셀 초안부터 4096픽셀 최종본까지, 1:8 세로형부터 8:1 배너까지 지원합니다. 비율은 요금을 바꾸지 않고 크기 단계만 요금을 바꿉니다. 2k의 4:1 배너는 폭 4128픽셀로 돌아왔습니다.
그리기 전에 검색
웹 검색은 날짜, 날씨, 명소 같은 최신 사실을, 이미지 검색은 실제 장소와 제품의 참고 사진을 가져옵니다. 둘 다 요청마다 켜고 끄는 선택 스위치입니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자입니다. 피사체, 장소, 빛, 렌즈를 완결된 문장으로 쓰십시오. 1자 이상 · 5000자 이하 |
aspect_ratio | 아니요 | 4:1, 1:4, 8:1, 1:8 같은 극단적인 배너 비율을 포함한 14가지 중에서 고릅니다. 기본값은 16:9이며 비율은 요금에 영향을 주지 않습니다. |
resolution | 아니요 | 0.5k, 1k(기본값), 2k, 4k 중 하나입니다. 정사각형 이미지는 한 변이 512, 1024, 2048, 4096픽셀이며 단계마다 요금이 다릅니다. |
enable_web_search | 아니요 | 기본값은 꺼짐입니다. 켜면 그리기 전에 날씨, 날짜, 명소 같은 최신 사실을 모델이 확인합니다. 기본값: |
enable_image_search | 아니요 | 기본값은 꺼짐입니다. 켜면 그리기 전에 웹에서 참고 이미지를 모델이 찾아봅니다. 기본값: |
official_fallback | 아니요 | 기본값은 켜짐입니다. 각 요청은 먼저 경제 경로에서 실행됩니다. 기본값: |
요금
크기 단계에 따른 장당 과금이며 비율은 요금에 영향을 주지 않습니다. 요청은 먼저 이코노미 경로에서 이코노미 가격으로 실행됩니다. Official fallback(기본값은 켜짐)이 켜져 있으면 이코노미 경로가 거부했거나 완료하지 못한 요청은 공식 경로(공식 가격)에서 다시 실행되므로, 견적에는 시작 가격과 최대 금액이 함께 표시됩니다. 끄면 이코노미 가격만 냅니다. 0.5k 요청과 웹 검색이나 이미지 검색을 켠 요청은 공식 경로에서 실행되며 검색마다 요금이 붙습니다. 공식 경로에서 이미지 대신 짧은 글로 돌아오는 거절은 생성 완료로 처리되어 공식 가격으로 과금됩니다. 그 밖의 거절은 과금되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.036 / 장 |
| $0.0384 / 장 (Official fallback 사용 시: 최대 $0.0536) |
| $0.0602 / 장 (Official fallback 사용 시: 최대 $0.0808) |
| $0.0902 / 장 (Official fallback 사용 시: 최대 $0.1208) |
활용 사례
웹 헤더와 옥외 광고
4:1과 8:1의 아주 넓은 배너를 나중에 이어 붙이거나 늘리지 않고 하나로 이어진 사진으로 렌더링합니다.
패션과 라이프스타일의 빠른 시안
0.5k와 1k로 한 시간에 여러 방향을 만들고, 가장 좋은 한 장을 납품용 2k로 다시 만듭니다.
실제 장소와 제품
이미지 검색을 켜면 실제 명소 앞이나 실제 제품이 나오는 장면에서 웹의 참고 사진에 기댈 수 있습니다.
모바일용 세로형
스토리와 사이드 배너용 1:4나 1:8 세로 이미지를 하나로 이어진 이미지로 생성합니다.
프롬프트 가이드 및 실전 팁
넓은 비율에서는 양 끝에도 내용을
4:1과 8:1에서는 왼쪽과 오른쪽 끝을 무엇이 채우는지(긴 해변, 스카이라인, 늘어선 가게) 적으십시오. 그렇지 않으면 양 끝이 빈 하늘이 됩니다.
검색은 사실을 위해, 스타일은 아님
웹 검색은 이미지가 최신이거나 실제인 무언가에 달려 있을 때 도움이 됩니다. 스타일이나 구도는 나아지지 않으므로 그 밖의 경우에는 꺼 두십시오.
작게 초안, 크게 납품
0.5k와 4k에 같은 프롬프트를 쓰십시오. 구도가 비슷하게 유지되므로 초안에서 정한 선택이 그대로 살아납니다.
납품은 2k로
2k에서는 정사각형의 한 변이 2048픽셀이라 대부분의 화면과 페이지에 충분합니다. 4k는 인쇄와 큰 크롭에 남겨 두십시오.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-2/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "16:9",
"enable_web_search": false,
"enable_image_search": false
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
