Retour aux guides
Clé API·18 juin 2026·Mis à jour le 24 septembre 2026·8 min de lecture

Créer une clé API Google Gemini — deux voies (Google AI Studio et Kunavo)

Comment créer une clé API Google Gemini — la voie officielle via Google AI Studio et la voie à clé unique via Kunavo, qui donne accès à Claude, GPT ainsi qu’à l’image et à la vidéo sans projet Google Cloud.

Une clé API Gemini authentifie vos appels aux modèles Gemini de Google : chaque requête transmet la clé dans l’en-tête Authorization, et la plateforme mesure et facture l’utilisation par son intermédiaire. Il existe deux façons de créer une clé API Gemini — directement via Google AI Studio (officiellement) ou via Kunavo : une clé compatible avec OpenAI qui donne accès à Gemini, Claude, GPT et aux modèles d’image et de vidéo, sans aucun projet Google Cloud.

Option 1 — Créer une clé API Google AI Studio (officielle)

Si Gemini est le seul modèle que vous appellerez, obtenez la clé directement auprès de Google :

  1. Accédez à aistudio.google.com et connectez-vous avec un compte Google.
  2. Ouvrez Get API key → Create API key. Les clés commencent par AIza… et ne sont affichées qu’une seule fois.
  3. Le niveau gratuit est limité en débit et convient au prototypage. Pour la production, associez la clé à un compte de facturation Google Cloud.

C’est la bonne méthode tant que vous n’avez besoin que de Gemini. Dès que vous utilisez également Claude, GPT ou des modèles d’image et de vidéo, vous gérez une clé, un SDK et une facture distincts pour chaque fournisseur.

Option 2 — Créer une clé API Gemini via Kunavo (recommandé pour la production)

Kunavo place Gemini derrière une API compatible avec OpenAI. Une seule clé sk-kn- donne accès à tous les modèles via le même point de terminaison — aucun projet Google Cloud requis, Gemini environ 70 % sous le tarif affiché par Google ($0.09 / $0.75 par million de tokens), un crédit Stripe, paiement à l’usage à partir d’un rechargement minimal de 10 $. Le crédit couvre ensemble Gemini, Claude, GPT ainsi que l’image et la vidéo et n’expire jamais.

  1. Inscrivez-vous. Créez un compte Kunavo sur kunavo.com.
  2. Ajoutez 10 $. Paiement à l’usage à partir d’un rechargement minimal de 10 $ ; le crédit n’expire jamais.
  3. Créez une clé. Générez-en une sur /app/keys. Elle commence par sk-kn- et n’est affichée qu’une seule fois — stockez-la dans une variable d’environnement.
  4. Appelez le modèle. Configurez le SDK OpenAI sur https://api.kunavo.com/v1 et appelez un slug Gemini.

Démarrage rapide

Conservez le SDK OpenAI officiel. Vous ne modifiez que base_url et le nom du modèle — rien d’autre.

gemini_quickstart.py
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # die einzige Zeile, die sich ändert
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Fasse die Handlung von Dune in zwei Sätzen zusammen."}],
)
print(resp.choices[0].message.content)

Le même schéma s’applique à Node.js et à curl ; les tarifs par modèle et les exemples chiffrés figurent dans le guide des tarifs de l’API Gemini.

Conserver la clé en sécurité

  • Variables d’environnement plutôt que code source. Ne stockez jamais la clé dans le dépôt ; lisez-la depuis une variable d’environnement. Ne l’intégrez jamais dans des bundles de navigateur ou de mobile — faites toujours transiter les requêtes par votre propre serveur.
  • Une clé par projet ou environnement. Ainsi, une clé divulguée peut être révoquée sans mettre tout le reste hors service.
  • Effectuez régulièrement une rotation. Kunavo autorise plusieurs clés actives, de sorte que la rotation se fait avec un chevauchement propre plutôt qu’une coupure brutale.
  • Limites de sortie par clé. Définissez des limites par clé dans le tableau de bord et surveillez le trafic inattendu de chaque clé sous /app/usage.

Questions fréquentes

Comment créer une clé API Google Gemini ?

Il existe deux façons. Officiellement : ouvrez aistudio.google.com, connectez-vous avec un compte Google, cliquez sur « Get API key » → « Create API key » ; la clé commence par AIza… et n’est affichée qu’une seule fois. Via Kunavo : inscrivez-vous sur kunavo.com, ajoutez au moins 10 $, générez une clé sur /app/keys et configurez le SDK OpenAI sur https://api.kunavo.com/v1. La seconde méthode ne nécessite aucun projet Google Cloud et la même clé permet également d’accéder à Claude, GPT ainsi qu’aux modèles d’image et de vidéo. Les deux méthodes prennent moins de cinq minutes.

Comment créer une clé API dans Google AI Studio ?

Dans Google AI Studio : ouvrez aistudio.google.com, connectez-vous avec votre compte Google, cliquez sur « Get API key » en haut à gauche, puis sur « Create API key » et choisissez un projet Google Cloud existant ou nouveau. La clé n’apparaît qu’une seule fois — copiez-la immédiatement et stockez-la dans une variable d’environnement. Le niveau gratuit est limité en débit ; pour un volume de production, associez le projet à un compte de facturation Google Cloud.

Qu’est-ce qu’une clé Gemini et où la retrouver ?

Une clé Gemini est une chaîne qui authentifie chaque requête adressée aux modèles Gemini de Google et l’associe à la facturation ; elle est transmise dans l’en-tête Authorization. Google n’affiche la clé complète qu’au moment de sa création — dans Google AI Studio, vous ne voyez ensuite plus que son nom et sa date de création. Si la clé est perdue, supprimez-la et créez-en une nouvelle ; elle ne peut pas être récupérée. Chez Kunavo, le principe est le même : la clé est affichée une seule fois, puis /app/keys ne montre que les métadonnées et la consommation.

Pourquoi ma clé API Gemini ne fonctionne-t-elle pas ?

La cause la plus fréquente de API_KEY_INVALID est une clé copiée incomplètement ou un espace ou retour à la ligne dans la variable d’environnement. Viennent ensuite : la clé appartient à un autre projet Google Cloud, l’API Gemini n’est pas activée dans le projet ou la clé a été révoquée. Vérifiez d’abord que la valeur commence exactement par AIza. Pour une clé Kunavo, la cause la plus fréquente est un crédit épuisé — cela renvoie 402, et non 401. La liste complète des erreurs figure dans le guide des clés API Gemini invalides.

L’API Gemini est-elle gratuite ?

Google AI Studio fournit une clé de niveau gratuit avec de faibles limites de débit, suffisantes pour le prototypage. Le trafic de production passe par une facturation payante. Chez Kunavo, le paiement à l’usage commence avec un rechargement minimal de 10 $, sans compte de facturation Google Cloud distinct — et votre crédit n’expire jamais.

Une clé API Gemini fonctionne-t-elle sans compte Google Cloud ?

Oui. Une clé Google AI Studio fonctionne pour le prototypage sans projet Google Cloud, mais elle est limitée en débit ; pour un volume de production, Google exige un compte de facturation Google Cloud. Une clé Kunavo ne nécessite aucun projet Google Cloud — vous appelez Gemini via le point de terminaison compatible avec OpenAI et vous réglez tout en une fois via Stripe.

Clé Gemini ou clé Kunavo — quelle est la différence ?

Une clé Google appelle uniquement Gemini et est facturée via un compte Google Cloud. Une clé Kunavo appelle Gemini ainsi que Claude, GPT et les modèles d’image et de vidéo via une API compatible avec OpenAI, avec un seul crédit Stripe — sans projet Google Cloud. Les prix par modèle figurent dans le guide des tarifs de l’API Gemini.

Avec quel modèle Gemini devrais-je commencer ?

Commencez avec gemini-2-5-flash pour le chat quotidien, l’extraction et la synthèse — rapide et très économique. Passez à gemini-3-1-pro pour un raisonnement plus complexe, la vision et les analyses avec un long contexte.