Nano Banana 2에서 2.1로 마이그레이션: API에서 무엇을 바꿔야 하나

Nano Banana 2.1은 계속 HiAPI의 비동기 작업 인터페이스를 사용하므로 코드 마이그레이션 양은 많지 않지만, 몇 가지 입력 제약을 다시 확인해야 합니다. 가장 눈에 띄는 변화는 model 값이며, 참조 이미지 수와 단일 파일 크기도 달라졌습니다. 가격은 출시 전 실시간 페이지와 작업 기록을 기준으로 삼아야 합니다.

이 글은 Nano Banana 2 모델 페이지와 Nano Banana 2.1 모델 페이지에서 현재 표시되는 인터페이스 계약을 바탕으로 정리했습니다. 예제는 현재 문서의 요청 구조를 사용하며, 프로덕션 트래픽을 전환하기 전에 잔액이 있는 테스트 계정에서 검증해야 합니다.

최소 변경은 model 교체

두 버전 모두 비동기 작업으로 생성합니다:

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "input": {
      "prompt": "A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering",
      "resolution": "1K",
      "aspect_ratio": "1:1",
      "output_format": "png"
    }
  }'

기존 요청이 텍스트-투-이미지였다면 마이그레이션의 핵심은 model 수정입니다:

- "model": "nano-banana-2"
+ "model": "gemini-nano-banana-2.1"

문서의 인터페이스는 여전히 POST /v1/tasks입니다. 요청이 수락되면 생성 인터페이스가 작업 ID를 반환하며, 이를 폴링이나 콜백 처리에 사용합니다. 기존 폴링 또는 콜백 흐름은 계속 사용할 수 있지만, 현재 작업 상태와 결과 필드는 여전히 확인해야 합니다.

유지 가능한 필드와 반드시 다시 확인해야 할 제한

2.1의 현재 계약은 2 버전에서 자주 쓰던 입력 필드를 유지합니다: prompt, 선택적 image_input, aspect_ratio, resolution, output_format. 아래의 잔액 보유 스모크 테스트는 텍스트-투-이미지와 참조 이미지 두 형식을 모두 수락했습니다. 정식 전환 시에는 버전 변화에 따라 실시간 계약을 여전히 확인해야 합니다.

참조 이미지 제한이 바뀌었습니다. Nano Banana 2 페이지에는 최대 14장, 단일 10 MB로 적혀 있지만, 2.1 페이지에는 최대 10장, 단일 30 MB로 적혀 있습니다. 모델 ID만 교체하고 기존의 14장 이미지를 계속 전달하면 요청이 새 버전의 상한을 초과하게 됩니다. 클라이언트는 새 버전의 상한에 맞춰 수량을 확인하고, 잘라낼지 사용자에게 바로 알릴지 결정해야 합니다.

2.1 모델 페이지에는 mask 입력이 공개되어 있지 않습니다. 마이그레이션 시 이후 인터페이스 문서에서 명시적으로 제공하지 않는 한 mask 필드를 임의로 추가하지 마세요. 이미지 편집은 image_input으로 원본 이미지를 전달한 뒤 prompt에 수정할 내용과 유지해야 할 세부 사항을 명확히 작성합니다.

{
  "model": "gemini-nano-banana-2.1",
  "input": {
    "prompt": "Keep the amber glass serum bottle and black dropper cap from the reference image. Place it on a sunlit wooden bathroom counter beside a folded cream linen towel and eucalyptus, preserving the bottle shape and blank label.",
    "image_input": ["https://static.hiapi.ai/blog/gemini-nano-banana-2-1-ecommerce-product-images/studio.jpg"],
    "resolution": "1K",
    "aspect_ratio": "16:9",
    "output_format": "png"
  }
}

이 요청은 잔액이 있는 스모크 테스트에서 성공적으로 완료되었으며, 결과 이미지는 여기에서 확인할 수 있습니다. 2.1 페이지에는 현재 참조 이미지가 JPEG, PNG, WebP를 지원하며 단일 30 MB를 초과하지 않는다고 명시되어 있습니다.

가격은 두 단계로 확인해야

2026-10-16 기준으로 모델 페이지를 확인했을 때, Nano Banana 2.1의 1K, 2K, 4K 티어는 각각 44, 72, 116 크레딧으로 표시되었습니다. 예산 계획 전에 실시간 가격 페이지와 모델 페이지를 확인하세요. 과금 읽기 검증은 여전히 별도로 확인해야 합니다.

프로모션 가격이나 특정 계정 페이지의 숫자를 장기 고정 가격으로 작성하지 마세요. 출시 검증 시 해상도, 제출 전 표시된 금액, 작업 완료 후 실제 과금을 기록하세요.

같은 프롬프트로 두 model ID 전환

마이그레이션 경로를 확인하기 위해 두 공개 model ID로 동일한 1K, 1:1 프롬프트를 각각 제출했습니다. 두 요청 모두 작업이 성공적으로 생성되어 success에 도달했습니다. 두 이미지의 병과 대면 세부 사항이 달라, 이 결과 세트는 라우팅과 결과 처리를 확인하기에 적합하지만 화질 순위를 매기기에는 부족하고 상품 동일성을 증명할 수도 없습니다.

두 요청에 사용한 프롬프트:

A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering

라우팅	Model ID	결과
Nano Banana 2	nano-banana-2	1K, 1:1, PNG, 작업 성공적으로 완료
Nano Banana 2.1	gemini-nano-banana-2.1	1K, 1:1, PNG, 작업 성공적으로 완료

이번 마이그레이션 검증은 2.1의 model ID가 현재 문서의 텍스트-투-이미지 작업 구조를 수락하고 동일한 비동기 흐름을 통해 이미지를 반환함을 보여줍니다. 단일 샘플 세트의 화면 차이는 관찰 자료로만 사용할 수 있으며 모델 비교 평가 결과로 삼을 수 없습니다.

출시 전 체크리스트

1. nano-banana-2를 정확한 새 버전 ID인 gemini-nano-banana-2.1로 교체합니다.
2. 비동기 POST /v1/tasks 흐름과 기존 작업 상태 처리를 유지합니다.
3. image_input이 공개 이미지 URL 배열이며 최대 10장인지 검증합니다.
4. 구버전의 단일 10 MB 가정을 2.1 페이지에 현재 명시된 30 MB 제한으로 변경합니다.
5. prompt, aspect_ratio, resolution, output_format을 유지하고, mask처럼 문서 근거가 없는 필드는 제거합니다.
6. 테스트 계정에서 순수 텍스트 작업과 참조 이미지 편집 작업을 각각 하나씩 전송하고, 요청, 작업 ID, 최종 상태, 결과 URL, 과금 금액을 저장합니다.
7. 구버전의 결과 및 오류 처리와 한 번 대조한 뒤 기본 모델을 모든 사용자에게 전환합니다.

가격 읽기 검증과 후속 유지보수

위의 스모크 테스트는 텍스트-투-이미지와 이미지-투-이미지의 요청 구조, 작업 생성, 종료 상태 성공, 결과 URL을 검증했습니다. 과금은 완료된 작업에서 독립적으로 읽어 검증하지 않았으므로, 생산 비용은 여전히 실시간 가격 페이지와 작업 기록을 기준으로 삼아야 합니다. 출시 전에 모델 페이지의 계약이나 제한이 변경되면 역시 다시 확인해야 합니다.

자주 묻는 질문

Nano Banana 2.1로 마이그레이션하려면 인터페이스를 바꿔야 하나요?

현재 두 모델 페이지 모두 POST /v1/tasks를 사용합니다. 먼저 모델 ID를 수정한 뒤 실제 요청으로 입력과 반환 구조를 검증하세요.

nano-banana-2를 계속 사용할 수 있나요?

이 ID는 여전히 Nano Banana 2를 의미합니다. 2.1을 호출해야 할 때는 gemini-nano-banana-2.1을 사용해야 합니다.

마이그레이션 후에도 참조 이미지 14장을 전달할 수 있나요?

2.1 모델 페이지에 현재 나열된 상한은 10장입니다. 수량을 초과하면 클라이언트에서 줄이거나 요청을 거부해야 합니다.

참조 이미지 편집은 다른 인터페이스로 바꿔야 하나요?

현재 페이지에는 별도의 편집 인터페이스가 없습니다. 동일한 모델 ID를 계속 사용하고 image_input을 추가하며, 프롬프트에 무엇을 바꿀지, 어떤 세부 사항을 유지할지 설명하세요.

2.1은 모든 계정에서 더 저렴한가요?

공개 페이지에는 현재 각 해상도의 표준 크레딧 숫자가 더 낮게 표시되지만, 가격이 조정될 수 있고 페이지가 계정이나 이벤트 상태에 영향을 받을 수도 있습니다. 비용 결론을 내리기 전에 실시간 가격과 작업 완료 후 과금 기록을 함께 확인하세요.

더 읽기

• Nano Banana 2.1 API 연동 튜토리얼
• Nano Banana 2.1 API 가격
• Nano Banana 2 API 사용 방법

HiAPI 모델 페이지에서 Nano Banana 2.1 체험하기.