Nano Banana API — OpenAI SDKそのまま、1枚あたりの価格と呼び出し方法

「ナノバナナAPI」を韓国語で検索すると、結果は2つに分かれます。Google公式ドキュメントか、「AI Studioでキーを取得する方法」というブログ記事です。本当に必要なのは、その間にある情報です。この記事では、既存のOpenAI SDKをそのまま使って呼び出す経路と、系列全体の1枚あたりの単価を1つの表にまとめます。Google Cloudプロジェクトは必要ありません。

1枚あたりの価格 — 系列全体

以下の料金は記事に手入力したものではなく、モデルカタログから読み取ります。価格が変わると、この表も変わります。

すべてper image基準で、サブスクリプションではなく前払い残高から差し引かれます。生成しない月には請求されません。

呼び出し — base_urlとモデル名だけを変更

すでにOpenAI SDKを使っているなら、新しく学ぶことはありません。クライアント初期化時のbase_urlとモデル名の2か所だけを変更します。

# 기존 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の画像エンドポイントと同じ形式です。そのため、すでに画像生成を組み込んだコードなら、モデル名の文字列1つで切り替えられます。

キーが機能するか先に確認する

コードを修正する前に、1回リクエストしてキーとアドレスを確認しておくと、その後エラーが発生した際に原因をコード側へ絞り込めます。

# 키가 되는지 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ならアップストリーム過負荷です。判別方法はClaude Codeのエラー整理の分岐表をそのまま適用できます。

どのグレードをデフォルトにするか

基本モデルをデフォルトにし、結果が不足する場合だけProに上げる方法が、費用対効果に最も優れています。モデル名の文字列を1つ変更するだけなので、比較実験のコストが実質ないという点を活用してください。同じプロンプトを2つのグレードで1回ずつ実行して決められます。

動画側の単価はVeo 3の価格に、英語版の詳細ドキュメントはNano Banana APIにあります。支払い方法と韓国国内カードの登録はClaude APIの価格・支払いにまとめています。

よくある質問