소개
Nano Banana Pro 텍스트→이미지는 2025년 11월 20일에 공개된 Google의 Gemini 3 Pro Image로, 글로 쓴 프롬프트에서 이미지를 생성합니다. 그리기 전에 요청을 추론하므로 빽빽한 글자, 도식, 여러 부분으로 된 레이아웃에 강하며, 10가지 비율로 1k, 2k, 4k를 렌더링하고 요금은 Google 정가보다 훨씬 낮은 가격부터 시작합니다.
가진 소재에 맞춰 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 글로 쓴 브리프 | Nano Banana Pro 텍스트→이미지 |
| 바꾸고 싶은 이미지 | Nano Banana Pro 이미지 편집 |
핵심 기능 및 하이라이트
이코노미 경로와 Official fallback
요청은 먼저 Google 정가보다 훨씬 낮은 가격의 이코노미 경로에서 실행됩니다. Official fallback(기본값은 켜짐)이 켜져 있으면 거기서 완료하지 못한 요청은 공식 경로에서 공식 가격으로 다시 실행됩니다. 어느 쪽이든 모델은 추론 단계를 갖춘 Google의 Gemini 3 Pro Image입니다.
그리기 전에 계획
모델이 먼저 레이아웃을 정하므로 각 요소의 위치를 적거나 여러 줄의 글자를 인용한 프롬프트는 적은 대로 배치되어 돌아옵니다. 저희 표지 테스트에서는 인용한 각 줄이 프롬프트에서 정한 자리에 들어갔습니다.
1k와 2k는 같은 요금
Google은 1K와 2K를 같은 요금으로 과금하므로 2k 해상도는 사실상 무료이고 4k는 더 비쌉니다. 저희 2k 렌더링은 대부분 20~45초 만에 돌아왔습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자입니다. 피사체, 장소, 빛, 렌즈를 완결된 문장으로 쓰십시오. 1자 이상 · 5000자 이하 |
aspect_ratio | 아니요 | 21:9부터 9:16까지 10가지 중에서 고릅니다. 기본값은 16:9이며 비율은 요금에 영향을 주지 않습니다. |
resolution | 아니요 | 1k(기본값), 2k, 4k 중 하나입니다. 1k와 2k는 요금이 같고, 4k는 더 비싸며 긴 변 4096픽셀로 생성합니다. |
official_fallback | 아니요 | 기본값은 켜짐입니다. 각 요청은 먼저 경제 경로에서 실행됩니다. 기본값: |
요금
크기 단계에 따른 장당 과금이며 비율은 요금에 영향을 주지 않습니다. 요청은 먼저 이코노미 경로에서 이코노미 가격으로 실행됩니다. Official fallback(기본값은 켜짐)이 켜져 있으면 이코노미 경로가 거부했거나 완료하지 못한 요청은 공식 경로(공식 가격)에서 다시 실행되므로, 견적에는 시작 가격과 최대 금액이 함께 표시됩니다. 끄면 이코노미 가격만 냅니다. 거부된 요청은 과금되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.0668 / 장 (Official fallback 사용 시: 최대 $0.1072) |
| $0.0668 / 장 (Official fallback 사용 시: 최대 $0.1072) |
| $0.118 / 장 (Official fallback 사용 시: 최대 $0.192) |
활용 사례
에디토리얼과 브랜드 인물 사진
지정한 렌즈, 조리개, 빛을 따르는 인물 사진으로, 피치 자료, 무드보드, 캠페인 시안에 씁니다.
글자가 들어간 레이아웃
포스터, 표지, 메뉴, 사인처럼 여러 글자가 사진과 화면을 나눠 쓰고 모두 철자가 맞아야 하는 작업.
도식과 인포그래픽
라벨이 붙은 도식, 간단한 차트, 단계별 비주얼처럼 추론 덕분에 각 라벨을 올바른 부분에 붙이기 쉬운 작업.
프롬프트 가이드 및 실전 팁
샷 리스트처럼 쓰기
피사체, 옷차림, 장소, 렌즈, 조리개, 빛의 방향, 색 보정을 이 순서로 완결된 문장에 담으십시오.
모든 글자를 인용하고 위치 적기
이미지에 들어갈 단어는 모두 따옴표로 감싸고 위치를 붙이십시오. 따옴표가 없는 단어는 묘사로 읽힙니다.
2k로 시작하기
이 모델에서는 1k와 요금이 같으므로 기본으로 2k로 생성하고 4k는 인쇄용으로 남겨 두십시오.
카메라는 문자 그대로
오른쪽 창문 빛에 85mm, f/1.4라고 적으면 그대로 따릅니다. 시네마틱 같은 모호한 단어는 선택을 모델에 맡깁니다.
인물은 옷과 동작으로 묘사하기
각 인물의 포즈, 옷, 표정, 위치를 적으면 계획 단계가 모두를 올바르게 배치하는 데 필요한 정보가 갖춰집니다.
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-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "16:9"
}
}'
# 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 레퍼런스에서 확인하세요.
