Sume의 Nano Banana Pro API: 4K 등급·화면 비율·편집

Sume에서 Nano Banana Pro API를 호출하려면 model: "google/nano-banana-pro"(또는 "google/nano-banana-2")와 prompt, 그리고 선택 필드인 resolution, aspect_ratio, input_references를 담아 POST /v1/images를 보내세요. 두 모델 모두 텍스트로 이미지를 생성하거나 최대 10장의 레퍼런스 이미지로 편집할 수 있고, 512, 1K, 2K, 4K 중 하나의 해상도로 렌더링하며, quality 파라미터는 받지 않습니다.

세부 내용은 Image API 문서 (영문), Image 1.0 페이지 (영문)의 Nano Banana 관련 설명, GET /v1/images/models의 카탈로그에서 가져왔으며, 2026-09-26에 확인했습니다.

어떤 Nano Banana 모델 ID를 보낼 수 있나요?

google/nano-banana-pro(카탈로그 이름 Nano Banana Pro) 또는 google/nano-banana-2(Nano Banana 2)를 보내세요. 접두어 없는 nano-banana-pro와 nano-banana-2도 별칭으로 동작합니다.

두 모델은 디스크립터 한 벌을 공유하며, 예외는 하나뿐입니다. Nano Banana 2의 비율 목록에는 4:1, 1:4, 8:1, 1:8도 추가로 들어 있습니다. 두 모델 모두 편집을 지원하며, 이미지 생성 API 모델에서 카탈로그의 나머지 모델과 비교합니다.

어떤 해상도를 고를 수 있고, 기본값은 무엇인가요?

두 모델 모두 resolution에 512, 1K, 2K, 4K 중 하나를 받으며, 생략하면 1K가 적용됩니다. 512의 예전 표기인 0.5K도 여전히 동작합니다. size는 같은 등급의 약칭이므로 size: "4K"도 동작합니다.

카탈로그에서 4K 등급이 있는 모델은 이 둘뿐입니다. 4K 렌더링은 30초 대기 시간을 넘길 가능성도 더 크므로, 200뿐 아니라 202 Job 봉투도 처리하세요. 모델 전반을 비교한 내용은 4K, 품질, 이미지 수에 있습니다.

Nano Banana에서 비율과 픽셀 크기는 어떻게 동작하나요?

auto를 쓰면 프로바이더가 비율을 고릅니다. Nano Banana는 커스텀 픽셀을 받지 않습니다. image_size에 넣은 WIDTHxHEIGHT나 { width, height } 값은 네이티브 비율로 매핑되므로, 1080×1350은 4:5가 됩니다. Nano Banana Pro는 1K에서 aspect_ratio: "4:5"를 약 928×1152로 렌더링합니다.

두 모델의 차이는 다음과 같습니다.

Nano Banana Pro로 이미지를 어떻게 편집하나요?

input_references에 공개 HTTPS 이미지 URL을 최대 10개까지 넣고, 출력이 레퍼런스를 따르도록 두 모델이 모두 나열하는 aspect_ratio: "auto"를 보내세요. 공통 레퍼런스 규칙은 레퍼런스 이미지 기반 이미지 생성 API에서 다룹니다.

curl -X POST "https://api.sume.com/v1/images" \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-pro",
    "prompt": "place this product on a marble counter in morning light",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/product.png" } }
    ],
    "aspect_ratio": "auto",
    "resolution": "2K"
  }'

Nano Banana는 무엇을 거부하나요?

모델이 나열하지 않은 파라미터는 조용히 무시되지 않고 400 unsupported_parameter로 거부됩니다. Nano Banana에서는 다음 요청이 실패합니다.

• 모든 quality 값. 두 모델 모두 이 필드를 지원한다고 밝히지 않습니다.
• mask_url이나 background. 이 필드는 ChatGPT Image 2.5 ID만 나열합니다.
• size에 넣은 픽셀. 픽셀은 image_size에 넣으세요. 그러면 비율로 매핑됩니다.
• 4보다 큰 n. 두 모델 모두 n의 상한이 4이며, 더 큰 값은 400 오류로 거부됩니다.

Nano Banana는 어떻게 과금되나요?

이미지 단위로 과금되며, 요율은 등급에 따라 다릅니다. 카탈로그 pricing 항목에는 1K 요율이 나와 있습니다. Nano Banana 2의 추정 비용은 512, 2K, 4K에서 달라지고, Nano Banana Pro는 4K에서만 달라지며 4K는 기본 등급보다 비용이 더 듭니다. 카탈로그 항목에는 Sume 마진이 포함되어 있고, 기본적으로 5.5% 에이전트 수수료가 더해집니다. API 요금을 참고하세요.