API nano banana — stesso OpenAI SDK, prezzo per immagine e modalità di chiamata

Cercando in coreano “API Nano Banana” i risultati si dividono in due: la documentazione ufficiale Google oppure un articolo sul blog intitolato «Come ottenere una chiave in AI Studio». Ciò che serve davvero si trova nel mezzo. Questo articolo mostra il percorso per effettuare chiamate mantenendo invariato l'SDK OpenAI esistente e raccoglie in un'unica tabella il costo per immagine dell'intera famiglia. Non è necessario un progetto Google Cloud.

Prezzo per immagine — Intera famiglia

Le tariffe riportate di seguito non sono inserite manualmente nell'articolo: vengono lette dal catalogo dei modelli. Quando i prezzi cambiano, cambia anche questa tabella.

Tutto è calcolato in base a per image e viene detratto dal saldo prepagato, non da un abbonamento. Nei mesi senza generazioni non viene addebitato nulla.

Chiamate — modifica solo base_url e nome del modello

Se utilizzi già l'SDK OpenAI, non devi imparare nulla di nuovo. Cambiano solo due elementi nell'inizializzazione del client: base_url e nome del modello.

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

L'endpoint è POST /v1/images/generations, con lo stesso formato dell'endpoint immagini di OpenAI. Se hai già integrato la generazione di immagini, puoi quindi passare da un modello all'altro modificando una sola stringa del nome del modello.

Verifica prima che la chiave funzioni

Prima di modificare il codice, verifica chiave e indirizzo con una singola richiesta. In questo modo, se in seguito si verifica un errore, puoi restringerne la causa al codice.

# 키가 되는지 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 di autenticazione, un 429 un limite di velocità e un 529 un sovraccarico upstream. La tabella decisionale di Riepilogo degli errori di Claude Code si applica direttamente anche qui.

Quale livello usare come predefinito

L'approccio più efficiente è usare il modello base come predefinito e passare a Pro solo per i casi in cui il risultato è insufficiente. Poiché basta modificare una stringa del nome del modello, sfrutta il fatto che il costo degli esperimenti comparativi è praticamente nullo: prova lo stesso prompt una volta con ciascun livello e decidi.

I prezzi dei video sono disponibili in Prezzi di Veo 3, mentre la documentazione dettagliata in inglese è in API Nano Banana. Metodi di pagamento e registrazione delle carte nazionali sono descritti in Prezzi e pagamenti dell'API Claude.

Domande frequenti