소개
Nano Banana 2 이미지 편집은 Google의 Gemini 3.1 Flash Image를 가지고 있는 이미지에 적용합니다. 원본 1~14장을 받고, 원본 비율을 유지하거나 14가지 비율 중 하나로 바꾸며, 0.5k, 1k, 2k, 4k로 렌더링합니다.
가진 소재에 맞춰 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 글로 쓴 브리프 | Nano Banana 2 텍스트→이미지 |
| 바꾸고 싶은 이미지 | Nano Banana 2 이미지 편집 |
핵심 기능 및 하이라이트
최대 14장의 참고 이미지
최대 14장의 이미지에서 인물, 옷, 장소, 제품을 합치고, 각각의 역할을 프롬프트에 적습니다. 이코노미 경로는 10장까지 받고, 그보다 많으면 공식 경로에서 실행되어 원본 한 장마다 소액의 고정 요금이 붙으므로 편집에 필요한 것만 넘기십시오.
편집하면서 다시 구성하기
비율 auto는 원본의 형태를 유지하고, 14가지 비율 중 하나를 고르면 결과물을 다시 구성합니다. 저희 예시에서는 4:1 배너가 16:9 밤 장면이 되었습니다.
어떤 크기에서도 빠르게
텍스트→이미지와 같은 단계로 0.5k 초안부터 4k 최종본까지, 요금은 단계로 정해지며, 공식 경로에서는 원본당 소액 요금이 더해집니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자입니다. 피사체, 장소, 빛, 렌즈를 완결된 문장으로 쓰십시오. 1자 이상 · 5000자 이하 |
image_urls | 예 | 원본 이미지는 1~14장입니다. 각 이미지가 무엇을 담당하는지(인물, 장소, 제품) 프롬프트에 적으십시오. 1개 이상 · 14개 이하 |
aspect_ratio | 아니요 | auto(기본값)는 원본 이미지의 비율을 유지합니다. 4:1, 1:4, 8:1, 1:8 같은 극단적인 배너 비율을 포함한 14가지 중에서 고를 수도 있습니다. |
resolution | 아니요 | 0.5k, 1k(기본값), 2k, 4k 중 하나입니다. 정사각형 이미지는 한 변이 512, 1024, 2048, 4096픽셀이며 단계마다 요금이 다릅니다. |
enable_web_search | 아니요 | 기본값은 꺼짐입니다. 켜면 그리기 전에 날씨, 날짜, 명소 같은 최신 사실을 모델이 확인합니다. 기본값: |
enable_image_search | 아니요 | 기본값은 꺼짐입니다. 켜면 그리기 전에 웹에서 참고 이미지를 모델이 찾아봅니다. 기본값: |
official_fallback | 아니요 | 기본값은 켜짐입니다. 각 편집은 먼저 경제 경로에서 실행됩니다. 기본값: |
요금
크기 단계에 따른 장당 과금입니다. 편집은 먼저 이코노미 경로에서 이코노미 가격으로 실행되며 원본당 요금은 붙지 않습니다. Official fallback(기본값은 켜짐)이 켜져 있으면 이코노미 경로가 거부했거나 완료하지 못한 편집, 그리고 원본이 10장을 넘는 편집은 공식 경로(공식 가격)에서 실행되며 원본 한 장마다 소액의 고정 요금도 붙습니다. 끄면 이코노미 가격만 냅니다. 0.5k 편집과 웹 검색이나 이미지 검색을 켠 편집은 공식 경로에서 실행되며 검색마다 요금이 붙습니다. 견적에는 시작 가격과 그 편집의 최대 금액이 표시됩니다. 공식 경로에서 이미지 대신 짧은 글로 돌아오는 거절은 생성 완료로 처리되어 공식 가격으로 과금됩니다. 그 밖의 거절은 과금되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.036 / 장 |
| $0.0384 / 장 (Official fallback 사용 시: 최대 $0.0536) |
| $0.0602 / 장 (Official fallback 사용 시: 최대 $0.0808) |
| $0.0902 / 장 (Official fallback 사용 시: 최대 $0.1208) |
활용 사례
장소와 시간대 변경
캠페인용으로 인물을 새 장소로 옮기거나 낮을 밤으로 바꾸고, 얼굴, 옷, 포즈는 그대로 유지합니다.
완성 이미지를 다른 비율로
넓은 배너를 16:9나 9:16 버전으로 바꾸고, 단순히 자르는 대신 가장자리에 새 내용을 더합니다.
제품 조합
여러 제품 사진을 스타일링된 한 장면에 배치하고, 각 제품과 놓을 자리를 짚어 줍니다.
프롬프트 가이드 및 실전 팁
남길 것을 나열하기
변경 사항을 적은 뒤 유지할 얼굴, 머리카락, 옷, 포즈를 짚으십시오. 모델은 분명하게 적힌 목록을 지킵니다.
다시 구성할 때는 새 프레이밍 적기
비율이 바뀔 때는 늘어난 공간에 무엇이 들어갈지(더 많은 하늘, 테이블 하나 더, 이어지는 거리) 적으십시오.
검색은 실제 참고가 필요할 때만
이미지 검색은 모델이 봐야 하는 실제 장소나 제품에 편집이 달려 있을 때만 켜십시오.
편집은 0.5k로 시험하기
먼저 지시를 0.5k로 시험하고, 편집이 잘 되면 같은 요청을 2k나 4k로 돌리십시오.
단계는 원본에 맞추기
원본에 없던 디테일은 편집으로 더할 수 없습니다. 원본 자체가 크지 않다면 대개 2k로 충분합니다.
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/edit",
"input": {
"aspect_ratio": "auto",
"enable_image_search": false,
"enable_web_search": false,
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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 레퍼런스에서 확인하세요.
