소개
Nano Banana Pro 이미지 편집은 Google의 Gemini 3 Pro Image를 가지고 있는 이미지에 적용합니다. 원본 1~14장을 받고, 그리기 전에 편집을 계획하며, 원본 비율이나 10가지 비율 중 하나로 1k, 2k, 4k를 돌려줍니다.
가진 소재에 맞춰 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 글로 쓴 브리프 | Nano Banana Pro 텍스트→이미지 |
| 바꾸고 싶은 이미지 | Nano Banana Pro 이미지 편집 |
핵심 기능 및 하이라이트
변경 하나의 정확한 편집
새 조명, 새 배경, 글자 추가를 인물과 이미지의 나머지는 그대로 둔 채 해냅니다. 저희 촛불과 표지 예시가 그렇습니다. 모델이 그리기 전에 편집을 계획하므로 관련 없는 부분이 안정적으로 유지됩니다.
사진 위 글자
제호, 호수, 캡션을 인용한 철자 그대로, 지정한 위치에 이미지 위로 얹습니다.
최대 14장의 참고 이미지
여러 원본에서 인물, 제품, 장소를 합치고 각각의 역할을 프롬프트에 적어 한 번의 편집 요청으로 묶습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자입니다. 피사체, 장소, 빛, 렌즈를 완결된 문장으로 쓰십시오. 1자 이상 · 5000자 이하 |
image_urls | 예 | 원본 이미지는 1~14장입니다. 각 이미지가 무엇을 담당하는지(인물, 장소, 제품) 프롬프트에 적으십시오. 1개 이상 · 14개 이하 |
aspect_ratio | 아니요 | auto(기본값)는 원본 이미지의 비율을 유지합니다. 21:9부터 9:16까지 10가지 중에서 고를 수도 있습니다. |
resolution | 아니요 | 1k(기본값), 2k, 4k 중 하나입니다. 1k와 2k는 요금이 같고, 4k는 더 비싸며 긴 변 4096픽셀로 생성합니다. |
official_fallback | 아니요 | 기본값은 켜짐입니다. 각 편집은 먼저 경제 경로에서 실행됩니다. 기본값: |
요금
크기 단계에 따른 장당 과금입니다. 편집은 먼저 이코노미 경로에서 이코노미 가격으로 실행되며 원본당 요금은 붙지 않습니다. Official fallback(기본값은 켜짐)이 켜져 있으면 이코노미 경로가 거부했거나 완료하지 못한 편집, 그리고 원본이 8장을 넘는 편집은 공식 경로(공식 가격)에서 실행되며 원본 한 장마다 소액의 고정 요금도 붙습니다. 끄면 이코노미 가격만 냅니다. 견적에는 시작 가격과 그 편집의 최대 금액이 표시됩니다. 거부된 요청은 과금되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.0668 / 장 (Official fallback 사용 시: 최대 $0.1072) |
| $0.0668 / 장 (Official fallback 사용 시: 최대 $0.1072) |
| $0.118 / 장 (Official fallback 사용 시: 최대 $0.192) |
활용 사례
사진을 표지와 포스터로
승인된 사진에 리터칭 없이 제호, 날짜, 문구 한 줄을 더합니다.
분위기와 조명 변형
방향을 고르는 클라이언트에게 같은 장면을 촛불, 새벽, 네온 조명으로 보여 줍니다.
현지화된 캠페인 이미지
완성된 포스터의 글자를 시장마다 번역한 한 줄로 바꾸고 사진과 그 빛은 그대로 둡니다.
프롬프트 가이드 및 실전 팁
한 번에 하나씩 바꾸기
변경이 하나인 지시는 나머지를 모두 안정적으로 유지합니다. 한 프롬프트에 몰아넣지 말고 편집을 이어 가십시오.
인물 보호하기
변경 사항 뒤에 똑같이 유지할 인물, 옷, 포즈를 짚으십시오.
편집 시간 감안하기
이 모델에서 편집은 텍스트→이미지보다 오래 걸립니다. 저희 테스트에서 공식 경로의 2k 편집은 최대 약 3분이 걸렸고, 이코노미 경로의 1k 편집은 1분 안에 끝났습니다.
글자는 위치와 함께 인용하기
추가하는 글자는 각 줄을 인용하고 놓을 곳(위쪽 가로로, 왼쪽 아래, 로고 옆)을 적으십시오.
기본은 2k로
이 모델에서는 1k와 2k의 요금이 같으므로 가벼운 파일이 필요한 경우가 아니라면 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-pro/edit",
"input": {
"aspect_ratio": "auto",
"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 레퍼런스에서 확인하세요.
