Clé API Gemini — comment l’obtenir et l’utiliser avec le SDK OpenAI

Une clé API Gemini est l’identifiant qui authentifie vos appels aux modèles Gemini de Google : chaque requête transmet la clé dans un en-tête Authorization, et son utilisation est mesurée et facturée par token. Il existe deux façons d’obtenir une clé fonctionnelle : Google AI Studio (officiel), qui fournit une clé dédiée à Gemini, ou Kunavo, où une seule clé compatible avec OpenAI donne accès à Gemini, Claude, GPT ainsi qu’aux modèles d’image, de vidéo et d’audio — sans nécessiter de projet Google Cloud. Ce guide explique comment obtenir une clé avec ces deux options et effectuer votre premier appel.

Option 1 — Google AI Studio (officiel)

C’est la bonne option si Gemini est le seul modèle que vous comptez appeler.

1. Connectez-vous à aistudio.google.com avec votre compte Google.
2. Ouvrez Get API key → Create API key. Les clés sont au format AIza....
3. Le niveau gratuit est limité et convient aux prototypes. Pour un volume de production, la clé doit être associée à un projet Google Cloud avec un compte de facturation actif.

Si vous utilisez également Claude, des modèles d’image ou de vidéo, cette option vous oblige à gérer une clé, un SDK et une facture distincts pour chaque fournisseur.

Option 2 — Kunavo (recommandé pour la production)

Kunavo place Gemini derrière une API compatible avec OpenAI. Une seule clé sk-kn- permet d’appeler Gemini et tous les autres modèles, avec un portefeuille unique facturé via Stripe et sans aucun projet Google Cloud. Gemini coûte environ 70% de moins que le tarif catalogue de Google — Flash, par exemple, coûte $0.09 par million de tokens d’entrée et $0.75 par million de tokens de sortie. Le paiement s’effectue à l’usage à partir d’un rechargement minimum de 10 $, et le solde n’expire jamais.

1. Inscrivez-vous sur kunavo.com.
2. Rechargez 10 $ — paiement à l’usage, le solde n’expire jamais.
3. Créez une clé dans /app/keys. Elle commence par sk-kn- et n’est affichée qu’une seule fois ; conservez-la dans une variable d’environnement.
4. Appelez l’API en configurant le SDK OpenAI pour utiliser https://api.kunavo.com/v1 et un slug Gemini.

Démarrage rapide

Conservez le SDK officiel d’OpenAI. Modifiez base_url et le nom du modèle — rien d’autre :

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # a única linha que muda
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Explique RAG em duas frases."}],
)
print(resp.choices[0].message.content)

Sécurité des clés

• N’exposez jamais une clé côté client. Les bundles navigateur et mobile sont publics — faites toujours transiter les appels par votre propre serveur. Stockez la clé dans des variables d’environnement, en dehors du code versionné.
• Utilisez une clé par projet ou environnement, afin de pouvoir révoquer une fuite sans interrompre les autres.
• Effectuez régulièrement une rotation. Kunavo autorise plusieurs clés actives simultanément, ce qui permet une transition fluide plutôt qu’une interruption brutale.
• Définissez une limite de dépenses par clé dans le tableau de bord et surveillez /app/usage pour détecter un trafic inattendu, ventilé par clé.

Questions fréquentes