API Nano Banana — même SDK OpenAI, prix par image et méthode d’appel

Une recherche en coréen sur l’API Nano Banana mène à deux types de résultats — la documentation officielle de Google ou un article expliquant comment obtenir une clé dans AI Studio. Ce dont vous avez réellement besoin se situe entre les deux. Cet article présente la méthode qui conserve votre SDK OpenAI existant et regroupe dans un seul tableau le prix par image de toute la famille. Aucun projet Google Cloud n’est requis.

Prix par image — toute la famille

Les tarifs ci-dessous sont lus depuis le catalogue des modèles, et non saisis manuellement dans l’article. Lorsque les prix changent, le tableau évolue également.

Tous les tarifs sont basés sur per image et sont déduits d’un solde prépayé, pas d’un abonnement. Aucun frais n’est facturé pendant les mois sans génération.

Appels — ne modifier que base_url et le nom du modèle

Si vous utilisez déjà le SDK OpenAI, rien de nouveau n’est à apprendre. Seuls deux éléments changent dans l’initialisation du client : base_url et le nom du modèle.

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

Le point de terminaison est POST /v1/images/generations, au même format que le point de terminaison d’images d’OpenAI. Si votre code prend déjà en charge la génération d’images, le changement se fait donc en modifiant une seule chaîne de nom de modèle.

Vérifier d’abord que la clé fonctionne

Avant de modifier le code, vérifiez la clé et l’adresse avec une seule requête. En cas d’erreur ultérieure, vous pourrez ainsi limiter la recherche de la cause au code.

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

Une réponse 401 indique un problème d’authentification, 429 une limitation de débit et 529 une surcharge de l’amont. Le tableau de décision de la synthèse des erreurs Claude Code s’applique directement.

Quel niveau choisir par défaut ?

Le meilleur rapport coût-efficacité consiste à utiliser le modèle de base par défaut et à passer à Pro uniquement lorsque le résultat est insuffisant. Comme il suffit de modifier une chaîne de nom de modèle, profitez du fait que le coût des essais comparatifs est pratiquement nul : exécutez le même prompt une fois avec chaque niveau, puis décidez.

Les tarifs vidéo figurent dans les tarifs de Veo 3, tandis que la documentation détaillée en anglais se trouve dans Nano Banana API. Les moyens de paiement et l’enregistrement des cartes coréennes sont expliqués dans Tarifs et paiements de l’API Claude.

Questions fréquentes