Documentation de référence de l'API Gemini

Cette documentation de référence de l'API décrit les API unaires, de streaming et en temps réel que vous pouvez utiliser pour interagir avec les modèles Gemini. Vous pouvez utiliser les API REST dans n'importe quel environnement compatible avec les requêtes HTTP. Pour savoir comment effectuer votre premier appel d'API, consultez le guide de démarrage. Si vous recherchez les références de nos bibliothèques et SDK spécifiques à un langage, accédez au lien correspondant dans le volet de navigation de gauche sous Références du SDK.

Points de terminaison principaux

L'API Gemini est organisée autour des principaux points de terminaison suivants :

• Interactions (CreateInteraction) (recommandé) : primitive standard recommandée pour créer des applications avec Gemini, optimisée pour les workflows d'agent, la gestion de l'état côté serveur et les conversations multimodales et multi-tours complexes.
• Génération de contenu standard (generateContent) : Point de terminaison REST standard qui traite votre requête et renvoie la réponse complète du modèle dans un seul package. Cette approche est idéale pour les tâches non interactives où vous pouvez attendre le résultat complet.
• Génération de contenu en streaming (streamGenerateContent) : utilise des événements envoyés par le serveur (SSE) pour vous envoyer des blocs de la réponse au fur et à mesure de leur génération. Cette approche offre une expérience plus rapide et plus interactive pour les applications telles que les chatbots.
• API Live (BidiGenerateContent) : API avec état basée sur WebSocket pour le streaming bidirectionnel, conçue pour les cas d'utilisation de conversation en temps réel.
• Mode batch (batchGenerateContent) :point de terminaison REST standard pour l'envoi de lots de requêtes generateContent.
• Embeddings (embedContent) : point de terminaison REST standard qui génère un vecteur d'embedding textuel à partir de l'entrée Content.
• API Gen Media : points de terminaison permettant de générer des contenus multimédias avec nos modèles spécialisés , tels qu'Imagen pour la génération d'images et Veo pour la génération de vidéos. Gemini dispose également de ces fonctionnalités intégrées, auxquelles vous pouvez accéder à l'aide de l'API generateContent.
• API de plate-forme : points de terminaison utilitaires qui prennent en charge les fonctionnalités de base telles que l'importation de fichiers et le comptage de jetons.

Authentification

Toutes les requêtes adressées à l'API Gemini doivent inclure un en-tête x-goog-api-key avec votre clé API. Créez-en une en quelques clics dans Google AI Studio.

Voici un exemple de requête avec la clé API incluse dans l'en-tête :

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Pour savoir comment transmettre votre clé à l'API à l'aide des SDK Gemini, consultez le guide Utiliser des clés API Gemini.