Nano Banana API — 直接使用 OpenAI SDK、每張價格與呼叫方法

以韓文搜尋 Nano Banana API 時，結果會分成兩類——Google 官方文件，或「如何在 AI Studio 取得金鑰」的部落格文章。 真正需要的是兩者之間的內容。本文整理保留現有 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 表示上游過載。判別方式可直接套用Claude Code 錯誤整理中的分支表。

應將哪個等級設為預設？

將基本模型設為預設，只有在結果不足時才升級至 Pro，成本效益最佳。只需變更一個模型名稱字串，因此請善用比較實驗的成本幾乎為零這一點——用相同提示詞各執行一次兩個等級，再做決定即可。

影片方面的價格請參閱Veo 3 價格；英文版詳細文件請參閱Nano Banana API。付款方式與韓國信用卡註冊資訊整理於Claude API 價格與付款。

常見問題