Comment obtenir une clé API Gemini — deux méthodes avec Google AI Studio et 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 : via Google AI Studio (officiel), ou avec une seule clé compatible OpenAI de Kunavo pour appeler Gemini, Claude, GPT et les modèles d’image/vidéo (sans projet Google Cloud). Ce guide explique les deux procédures et indique laquelle choisir en production.

Méthode 1 — Google AI Studio (officiel)

Si vous utilisez uniquement Gemini, obtenir directement la clé auprès de Google est la voie classique.

1. Connectez-vous à aistudio.google.com avec votre compte Google.
2. Ouvrez Obtenir une clé API → Créer une clé API. La clé se présente sous la forme AIza....
3. Pour les prototypes, une offre gratuite soumise à des limites de débit est disponible. Pour un volume de production, vous devez associer la clé à un projet Google Cloud dont la facturation est activée.

Si le seul modèle appelé est Gemini, c’est le bon choix. 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 une API compatible OpenAI. Une seule clé sk-kn- donne accès à Gemini et à tous les autres modèles, sans projet Google Cloud, avec les paiements regroupés sur un seul solde Stripe. Gemini coûte environ 70 % de moins que le tarif catalogue de Google, avec une facturation à l’usage à partir de 10 $.

1. Inscription — Créez un compte sur kunavo.com.
2. Recharger 10 $ — Facturation à l’usage, sans expiration du solde.
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 donc dans une variable d’environnement.
4. Appeler l’API — Dirigez le base_url du SDK OpenAI vers https://api.kunavo.com/v1 et indiquez le slug Gemini.

Le tableau comparatif de la documentation des clés API Gemini permet également de vérifier quelle méthode vous convient. Pour le détail des tarifs, consultez le guide des tarifs de l’API Gemini.

Démarrage rapide

Utilisez directement le SDK officiel OpenAI. Il suffit de modifier base_url et le nom du modèle.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 変更するのはこの 1 行だけ
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",  # Gemini モデルのスラッグを指定
    messages=[{"role": "user", "content": "Gemini を一文で説明して。"}],
)
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 ; chargez-la depuis 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 permet de conserver plusieurs clés actives simultanément ; la rotation peut donc se faire par chevauchement propre plutôt que par basculement brutal. Une rotation trimestrielle est recommandée.
• Définissez une limite pour chaque clé. Définissez une limite par clé dans le tableau de bord et séparez les clés par projet ou environnement. Ainsi, en cas de fuite, vous pouvez révoquer uniquement la clé concernée sans interrompre l’ensemble du service. Surveillez le trafic par clé via /app/usage.

Questions fréquentes