Obtenir une clé API Gemini — guide pas à pas avec Google AI Studio et Kunavo

Une clé d’API Gemini est un identifiant bearer qui authentifie vos appels aux modèles Gemini de Google. Vous pouvez obtenir la clé de deux façons : directement auprès de Google AI Studio (la voie officielle) ou via Kunavo — une seule clé compatible avec OpenAI pour Gemini, Claude, GPT et les modèles d’image et de vidéo, sans configurer de projet Google Cloud. Ce guide présente les deux méthodes étape par étape et vous permet d’appeler Gemini en quelques minutes.

Option 1 — Google AI Studio (officielle)

Si vous souhaitez utiliser uniquement Gemini, vous pouvez obtenir une clé directement auprès de Google :

1. Connectez-vous à aistudio.google.com avec un compte Google.
2. Suivez Get API key → Create API key. Les clés commencent par AIza....
3. Un niveau gratuit limité, avec des limites de débit, est disponible pour le prototypage.
4. Pour les volumes de production, vous devez associer la clé à un projet Google Cloud dont la facturation est activée.

C’est la bonne méthode lorsque Gemini est le seul modèle que vous appellerez. Si vous utilisez également des modèles Claude, d’image ou de vidéo, vous devrez gérer une clé, un SDK et une facture distincts pour chaque fournisseur.

Option 2 — Kunavo (recommandée pour la production)

Kunavo propose Gemini derrière une API compatible avec OpenAI. Une seule clé sk-kn- donne accès à Gemini et à tous les autres modèles (via un endpoint compatible avec OpenAI) — aucun projet Google Cloud n’est nécessaire. Gemini est facturé environ 70 % moins cher que le tarif catalogue de Google, un seul solde Stripe couvre tout et vous commencez avec un modèle à l’usage à partir de 10 $.

1. Créez un compte Kunavo et rechargez-le de 10 $ — paiement à l’usage, le solde n’expire jamais.
2. Créez une clé sur la page /app/keys. La clé ne s’affiche qu’une seule fois ; stockez-la dans une variable d’environnement.
3. Pointez le SDK OpenAI vers https://api.kunavo.com/v1 et appelez un slug Gemini.
4. Appelez-le — envoyez le champ model avec une valeur telle que gemini-2-5-flash, et c’est tout.

Démarrage rapide

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

import os
from openai import OpenAI

# Resmi OpenAI SDK'sını koruyun; yalnızca base_url ve model değişir.
client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # değişen tek satır
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Merhaba Gemini, kendini bir cümleyle tanıt."}],
)
print(resp.choices[0].message.content)

Gardez votre clé secrète

• N’exposez jamais la clé côté client. Les navigateurs et les packages mobiles sont publics — utilisez toujours un proxy sur votre propre serveur. Conservez les clés dans les fichiers .env et les variables d’environnement, et ne les intégrez jamais au code source.
• Utilisez une clé distincte par projet ou environnement afin qu’une fuite puisse être révoquée sans désactiver tout le reste.
• Effectuez régulièrement une rotation. Kunavo autorise plusieurs clés actives simultanément ; la rotation devient ainsi une transition progressive propre plutôt qu’une interruption brutale.
• Définissez des limites de dépenses par clé. Définissez une limite pour chaque clé depuis le tableau de bord et surveillez le trafic inattendu par clé sur la page /app/usage.

FAQ