나노 바나나 API — OpenAI SDK 그대로, 장당 가격과 호출법

나노 바나나 API를 한국어로 찾으면 결과가 둘로 갈립니다 — Google 공식 문서, 아니면 「AI 스튜디오에서 키 받는 법」 블로그 글. 정작 필요한 건 그 사이입니다. 이 글은 기존 OpenAI SDK를 그대로 두고 호출하는 경로와, 계열 전체의 장당 단가를 한 표에 정리합니다. Google Cloud 프로젝트는 필요 없습니다.

장당 가격 — 계열 전체

아래 요율은 글에 적어 넣은 것이 아니라 모델 카탈로그에서 읽어옵니다. 가격이 바뀌면 이 표도 함께 움직입니다.

모두 per image 기준이며, 구독이 아니라 선불 잔액에서 차감됩니다. 생성하지 않은 달에는 청구가 없습니다.

호출 — base_url과 모델 이름만 바꿉니다

이미 OpenAI SDK를 쓰고 있다면 새로 배울 것이 없습니다. 클라이언트 초기화의 base_url과 모델 이름 두 곳만 바뀝니다.

# 기존 OpenAI SDK를 그대로 씁니다. base_url과 모델 이름만 바뀝니다.
# Google Cloud 프로젝트도, 별도 SDK 설치도 필요 없습니다.
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.kunavo.com/v1",
    api_key=os.environ["KUNAVO_API_KEY"],
)

img = client.images.generate(
    model="nano-banana-2",
    prompt="한옥 마당에 눈이 내리는 장면, 따뜻한 조명, 사진 스타일",
    n=1,
)
print(img.data[0].url)

엔드포인트는 POST /v1/images/generations로, OpenAI의 이미지 엔드포인트와 같은 형식입니다. 따라서 이미 이미지 생성을 붙여 둔 코드가 있다면 모델 이름 문자열 하나로 전환됩니다.

키가 되는지 먼저 확인하기

코드를 고치기 전에 요청 한 번으로 키와 주소를 확인해 두면, 이후 오류가 났을 때 원인을 코드 쪽으로 좁힐 수 있습니다.

# 키가 되는지 30초 만에 확인하는 최소 요청
curl -sS https://api.kunavo.com/v1/images/generations \
  -H "Authorization: Bearer sk-kn-..." \
  -H "content-type: application/json" \
  -d '{"model":"nano-banana","prompt":"a paper crane on a desk","n":1}'

401이 오면 인증, 429면 속도 제한, 529면 업스트림 과부하입니다. 구분법은 클로드 코드 오류 정리의 분기표가 그대로 적용됩니다.

어느 등급을 기본값으로 둘 것인가

기본 모델을 기본값으로 두고, 결과가 부족한 건에만 Pro로 올리는 방식이 비용 대비 효율이 가장 좋습니다. 모델 이름 문자열 하나만 바꾸면 되므로비교 실험의 비용이 사실상 없다는 점을 활용하세요 — 같은 프롬프트를 두 등급으로 한 번씩 돌려 보고 결정하면 됩니다.

영상 쪽 단가는 Veo 3 가격에, 영어판 상세 문서는 Nano Banana API에 있습니다. 결제 수단과 국내 카드 등록은 Claude API 가격·결제에 정리돼 있습니다.

자주 묻는 질문