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

Une clé API Gemini authentifie vos appels aux modèles Gemini de Google : chaque requête porte la clé dans l'en-tête Authorization, et la plateforme mesure et facture l'usage à travers elle. Il y a deux façons d'obtenir une clé API Gemini — directement via Google AI Studio (la voie officielle), ou via Kunavo : une clé compatible OpenAI qui atteint Gemini plus Claude, GPT et les modèles d'image et de vidéo, sans aucun projet Google Cloud.

Option 1 — Google AI Studio (officielle)

Si Gemini est le seul modèle que vous appellerez jamais, prenez la clé directement chez Google :

1. Ouvrez aistudio.google.com et connectez-vous avec un compte Google.
2. Allez dans Get API key → Create API key. Les clés commencent par AIza… et ne s'affichent 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 voie tant que vous n'avez besoin que de Gemini. Dès que vous utilisez aussi Claude, GPT ou des modèles d'image et de vidéo, vous gérez une clé, un SDK et une facture par fournisseur.

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

Kunavo place Gemini derrière une API compatible OpenAI. Une seule clé sk-kunavo- atteint tous les modèles sur le même endpoint — aucun projet Google Cloud, Gemini environ 70 % sous le prix catalogue de Google ($0.09 / $0.75 par 1M de tokens), un solde Stripe, pay-as-you-go dès $5 de recharge. Le solde couvre Gemini, Claude, GPT, l'image et la vidéo ensemble, et n'expire jamais.

1. Inscrivez-vous. Créez un compte Kunavo sur kunavo.com.
2. Rechargez $5. Pay-as-you-go à partir d'une recharge minimum de $5 ; le solde n'expire jamais.
3. Créez la clé. Générez une clé dans /app/keys. Elle commence par sk-kunavo- et ne s'affiche qu'une fois — stockez-la dans une variable d'environnement.
4. Appelez. Pointez le SDK OpenAI vers https://api.kunavo.com/v1 et appelez un slug Gemini.

Quickstart

Gardez le SDK OpenAI officiel. Vous ne changez que 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",  # la seule ligne qui change
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Résume l'intrigue de Dune en deux phrases."}],
)
print(resp.choices[0].message.content)

Le même pattern vaut pour Node.js et curl ; les tarifs par modèle et les exemples détaillés sont dans le guide des prix de l'API Gemini.

Garder la clé en sécurité

• Variables d'environnement, pas de code source. Ne commitez jamais la clé dans le dépôt ; lisez-la depuis une variable d'environnement. Ne l'exposez jamais dans un bundle navigateur ou mobile — passez toujours par votre propre serveur.
• Une clé par projet ou environnement. Une clé fuitée se révoque alors sans rien casser d'autre.
• Rotation régulière. Kunavo autorise plusieurs clés actives, donc la rotation est un chevauchement propre plutôt qu'une coupure brutale.
• Plafonds de dépense par clé. Fixez des limites par clé dans le dashboard et surveillez le trafic inattendu par clé dans /app/usage.

FAQ

La clé API Gemini est-elle gratuite ?

Google AI Studio délivre une clé gratuite à débit limité, suffisante pour prototyper ; le trafic de production passe par la facturation payante. Chez Kunavo, c'est du pay-as-you-go dès $5 de recharge, sans compte de facturation Google Cloud — et votre solde n'expire jamais.

Sans compte Google Cloud, c'est possible ?

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 n'a besoin d'aucun projet Google Cloud — vous appelez Gemini via l'endpoint compatible OpenAI et réglez tout via Stripe.

Clé Gemini vs clé Kunavo ?

Une clé Google n'appelle que Gemini et se facture via un compte Google Cloud. Une clé sk-kunavo- appelle Gemini plus Claude, GPT et les modèles d'image et de vidéo via une API compatible OpenAI, avec un seul solde Stripe. Les prix par modèle sont dans le guide des prix de l'API Gemini.

Avec quel modèle Gemini commencer ?

Commencez avec gemini-2-5-flash pour le chat courant, l'extraction et le résumé — rapide et très économique. Passez à gemini-2-5-pro pour le raisonnement difficile, la vision et les analyses à long contexte.