Nano Banana API — 使用原有 OpenAI SDK，单张价格与调用方法

用韩语搜索纳米香蕉 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 价格与支付中。

常见问题