Documentation
Clé API Gemini
Comment obtenir une clé API Gemini et appeler les modèles Gemini Pro et Flash via un point de terminaison compatible avec OpenAI — la méthode directe avec Google AI Studio et celle de Kunavo, qui utilise une seule clé pour accéder aussi à Claude, GPT-Image, Veo et Suno.
Une clé API Gemini authentifie vos appels aux modèles Gemini de Google. Vous pouvez l’obtenir directement auprès de Google AI Studio ou utiliser une seule clé sk-kn- pour accéder à Gemini via la même API compatible avec OpenAI que vous utilisez déjà pour tout le reste.
/app/keys, définissez base_url=https://api.kunavo.com/v1, puis appelez model="gemini-2-5-flash". Aucun projet Google Cloud n’est nécessaire, et la même clé fonctionne aussi avec Claude, GPT-Image et Veo.Qu’est-ce qu’une clé API Gemini ?
Une clé API Gemini est un identifiant Bearer qui autorise les requêtes à la famille de modèles Gemini de Google. Chaque requête transmet la clé dans un en-tête Authorization ; la plateforme mesure l’utilisation associée et facture par jeton. Sur Kunavo, cela concerne actuellement gemini-3-1-pro et gemini-2-5-flash, appelés via le point de terminaison compatible avec OpenAI.
Il existe deux façons d’obtenir une clé fonctionnelle, selon que vous souhaitez utiliser Gemini seul ou avec d’autres modèles de pointe.
Option A — une clé directement depuis Google AI Studio
- Rendez-vous sur
aistudio.google.comet connectez-vous avec un compte Google. - Ouvrez Get API key → Create API key. Les clés ressemblent à
AIza.... - Pour un volume de production, associez la clé à un projet Google Cloud dont la facturation est activée.
C’est la bonne solution si Gemini est le seul modèle que vous utiliserez. Si vous utilisez aussi Claude, des modèles d’image ou de vidéo, vous devrez gérer une clé, un SDK et une facture distincts pour chaque fournisseur.
Option B — une seule clé Kunavo pour Gemini et tous les autres services
Kunavo est une passerelle indépendante d’API IA compatible avec OpenAI : une seule clé API et un solde à l’usage vous donnent accès à Claude, GPT ainsi qu’à des modèles d’image, de vidéo et d’audio, sans compte par fournisseur.
Kunavo donne accès à Gemini via une API compatible avec OpenAI. Une seule clé sk-kn- permet d’accéder à Gemini et à tous les autres modèles, avec un solde unique facturé par Stripe.
| Clé Google AI Studio | Clé Kunavo | |
|---|---|---|
| Modèles | Gemini uniquement | Gemini + Claude, GPT-Image, Veo, Suno |
| Point de terminaison | API Google GenAI | https://api. |
| Facturation | Compte Google Cloud | Un portefeuille Stripe |
| Montant minimum pour commencer | Offre gratuite (débit limité) | Rechargement de $10, sans expiration |
| Format de clé | AIza... | sk-kn-... |
- Créez un compte Kunavo et ajoutez un rechargement de $10 — paiement à l’utilisation, solde sans date d’expiration.
- Générez une clé sur
/app/keys. Elle n’est affichée qu’une fois ; stockez-la dans une variable d’environnement. - Configurez le SDK OpenAI pour utiliser
https://api.kunavo.com/v1et appelez un identifiant Gemini.
Appeler Gemini avec Python
Conservez le SDK officiel 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", # the only line that changes
)
resp = client.chat.completions.create(
model="gemini-2-5-flash",
messages=[{"role": "user", "content": "Summarize the plot of Dune in two sentences."}],
)
print(resp.choices[0].message.content)Appeler Gemini avec Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.KUNAVO_API_KEY,
baseURL: "https://api.kunavo.com/v1",
});
const resp = await client.chat.completions.create({
model: "gemini-2-5-flash",
messages: [{ role: "user", content: "Summarize the plot of Dune in two sentences." }],
});
console.log(resp.choices[0].message.content);baseURL avec Node et base_url avec Python. Les deux pointent vers le même point de terminaison.Ou appelez-le avec curl
curl https://api.kunavo.com/v1/chat/completions \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2-5-flash",
"messages": [{"role": "user", "content": "Hello, Gemini"}]
}'Quel modèle Gemini utiliser ?
- gemini-2-5-flash — modèle rapide et extrêmement économique par défaut pour les conversations, l’extraction et la synthèse.
- gemini-3-1-pro — raisonnement plus performant, vision et analyse de longs contextes.
Liste de contrôle de sécurité
- N’exposez jamais une clé côté client. Les bundles pour navigateur et mobile sont publics — faites toujours transiter les requêtes par votre propre serveur.
- Utilisez une clé par projet ou environnement afin de pouvoir révoquer une clé compromise sans interrompre le reste.
- Effectuez une rotation tous les trimestres. Kunavo autorise plusieurs clés actives ; vous pouvez donc les faire se chevaucher sans coupure brutale.
- Surveillez
/app/usagepour détecter le trafic inhabituel ventilé par clé.
FAQ
Une clé API Gemini est-elle gratuite ?
Google AI Studio fournit une clé de niveau gratuit avec des limites de débit basses, adaptée au prototypage. Le trafic en production passe à la facturation payante. Sur Kunavo, vous payez à l’utilisation à partir d’un rechargement minimum de $10, sans compte de facturation Google Cloud distinct ; votre solde n’expire jamais.
Puis-je utiliser Gemini avec le SDK OpenAI ?
Oui. Kunavo expose Gemini via le point de terminaison /v1/chat/completions compatible avec OpenAI : vous conservez le SDK officiel OpenAI et modifiez uniquement base_url pour utiliser https://api.kunavo.com/v1, puis définissez le nom du modèle sur un identifiant Gemini, tel que gemini-2-5-flash.
Quelle est la différence entre une clé API Google Gemini et une clé API Kunavo ?
Une clé Google permet d’appeler uniquement Gemini et la facturation passe par un compte Google Cloud. Une clé Kunavo permet d’appeler Gemini, Claude, GPT-Image, Veo et Suno via une seule API compatible avec OpenAI, avec une facturation unique par Stripe.
Quel modèle Gemini choisir pour commencer ?
Commencez par gemini-2-5-flash pour les conversations courantes, l’extraction et la synthèse : il est rapide et extrêmement économique. Passez à gemini-3-1-pro pour les raisonnements plus complexes, la vision et l’analyse de longs contextes.