API de Nano Banana: mismo SDK de OpenAI, precio por imagen y cómo llamar

Si buscas la API de Nano Banana en coreano, los resultados suelen dividirse en dos: la documentación oficial de Google o artículos sobre cómo obtener una clave en AI Studio. Lo que hace falta está entre ambos. Este artículo resume la ruta para llamar usando el SDK de OpenAI existente y reúne en una tabla los precios por imagen de toda la familia. No necesitas un proyecto de Google Cloud.

Precio por imagen — toda la familia

Las tarifas siguientes no están escritas manualmente en el artículo: se leen del catálogo de modelos. Si cambian los precios, la tabla también cambiará.

Todos se calculan según per image y se descuentan de un saldo prepago, no de una suscripción. No se cobra nada en los meses sin generaciones.

Llamadas — cambia solo base_url y el nombre del modelo

Si ya usas el SDK de OpenAI, no tienes que aprender nada nuevo. Solo cambian dos elementos de la inicialización del cliente: base_url y el nombre del modelo.

# 기존 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)

El endpoint es POST /v1/images/generations, con el mismo formato que el endpoint de imágenes de OpenAI. Si ya tienes código de generación de imágenes, puedes cambiar de modelo modificando una sola cadena.

Comprueba primero que la clave funciona

Antes de modificar el código, verifica la clave y la dirección con una solicitud. Así, si aparece un error después, podrás acotar la causa al código.

# 키가 되는지 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}'

Un 401 indica un problema de autenticación, un 429 un límite de solicitudes y un 529 una sobrecarga del upstream. Para distinguirlos, se aplica directamente la tabla de decisión de Resumen de errores de Claude Code.

Qué nivel usar como opción predeterminada

Usa el modelo básico como opción predeterminada y cambia a Pro solo cuando el resultado sea insuficiente. Como solo tienes que cambiar una cadena con el nombre del modelo, aprovecha que el coste de los experimentos comparativos es prácticamente nulo: ejecuta el mismo prompt una vez en cada nivel y decide.

Los precios de vídeo están en el precio de Veo 3; la documentación detallada en inglés está en la API de Nano Banana. Los métodos de pago y el registro de tarjetas nacionales se resumen en Precios y pagos de la API de Claude.

Preguntas frecuentes