Comment obtenir une clé API Gemini — Google AI Studio ou Kunavo

Une clé API Gemini est un identifiant d’authentification Bearer qui autorise les appels aux modèles Gemini de Google. Il existe deux façons d’en obtenir une : recevoir une clé officielle dans Google AI Studio, ou appeler Gemini, Claude, GPT et les modèles d’image/vidéo avec une seule clé compatible OpenAI de Kunavo (sans projet Google Cloud). Ce guide compare les deux voies et montre le moyen le plus rapide de commencer immédiatement les appels en production.

Méthode 1 — Google AI Studio (officiel)

Si vous prévoyez d’appeler uniquement Gemini, obtenir directement la clé auprès de Google est la solution appropriée.

1. Accédez à aistudio.google.com et connectez-vous avec votre compte Google.
2. Créez une clé via Get API key → Create API key. La clé se présente sous la forme AIza....
3. L’offre gratuite destinée au prototypage est soumise à des limites de requêtes et convient au développement initial.
4. Pour traiter un volume de production, vous devez associer la clé à un compte de facturation Google Cloud dont la facturation est activée.

Si Gemini reste le seul modèle appelé, cette voie convient. En revanche, si vous utilisez aussi Claude ou des modèles d’image et de vidéo, vous devrez gérer séparément les clés, les SDK et les factures de chaque fournisseur.

Méthode 2 — Kunavo (recommandée en production)

Kunavo place Gemini derrière un point de terminaison compatible OpenAI. Une seule clé sk-kn- permet d’appeler tous les modèles et les paiements sont regroupés sur un seul solde Stripe ; aucun projet Google Cloud n’est requis. Gemini coûte environ 70 % de moins que le tarif catalogue de Google ; le solde n’expire pas et la facturation à l’usage commence par un rechargement minimum de 10 $.

1. Inscription — Créez un compte sur kunavo.com.
2. Recharger 10 $ — Payez selon l’utilisation ; le solde n’expire pas.
3. Créer une clé — Créez une clé via /app/keys. Elle commence par sk-kn- et n’est affichée qu’une seule fois ; enregistrez-la dans une variable d’environnement.
4. Appeler l’API — Définissez le base_url du SDK OpenAI sur https://api.kunavo.com/v1 et appelez le slug Gemini.

Démarrage rapide

Utilisez directement le SDK officiel OpenAI. Modifiez uniquement base_url et le nom du modèle — rien d’autre ne change.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 바뀌는 건 이 줄뿐입니다
)

# 모델 슬러그만 바꾸면 Claude, GPT 등 다른 모델도 같은 키로 호출됩니다
resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "두 문장으로 자기소개를 해줘."}],
)
print(resp.choices[0].message.content)

Gérer les clés en toute sécurité

• Utilisez des variables d’environnement. Ne codez pas la clé en dur ; conservez-la dans une variable telle que KUNAVO_API_KEY. Les bundles navigateur et mobile sont publics : n’exposez jamais la clé côté client et faites toujours transiter les appels par votre propre serveur.
• Effectuez régulièrement une rotation. Kunavo autorise plusieurs clés actives ; vous pouvez donc effectuer la rotation par chevauchement propre plutôt que par basculement brutal. Une rotation trimestrielle est recommandée.
• Définissez une limite de dépense par clé. Définissez une limite pour chaque clé dans le tableau de bord et consultez son utilisation via /app/usage. Ainsi, même en cas de fuite, vous pouvez révoquer la clé concernée sans toucher aux autres.

Questions fréquentes