Guide de démarrage rapide de l'API Gemini

Ce guide de démarrage rapide explique comment installer nos bibliothèques et effectuer votre première requête d'API Gemini à l'aide de l'API Interactions.

Avant de commencer

L'utilisation de l'API Gemini nécessite une clé API. Vous pouvez en créer une sans frais pour commencer.

Créer une clé API Gemini

Installer le SDK Google GenAI

Python

Si vous utilisez Python 3.9 ou une version ultérieure, installez le google-genai package à l'aide de la commande pip suivante :

pip install -q -U google-genai

JavaScript

Si vous utilisez Node.js v18 ou une version ultérieure, installez le SDK Google Gen AI pour TypeScript et JavaScript à l'aide de la commande npm suivante :

npm install @google/genai

Créer votre première requête

Voici un exemple qui utilise l'API Interactions pour envoyer une requête à l'API Gemini à l'aide du modèle Gemini 3 Flash.

Si vous définissez votre clé API comme variable d'environnement GEMINI_API_KEY, elle sera automatiquement récupérée par le client lorsque vous utiliserez les bibliothèques de l'API Gemini. Sinon, vous devrez transmettre votre clé API en tant qu'argument lors de l'initialisation du client.

Notez que tous les exemples de code de la documentation de l'API Gemini supposent que vous avez défini la variable d'environnement GEMINI_API_KEY.

Python

from google import genai

# The client gets the API key from the environment variable `GEMINI_API_KEY`.
client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3-flash-preview", 
    input="Explain how AI works in a few words"
)

# Print the model's text response
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)

JavaScript

import { GoogleGenAI } from "@google/genai";

// The client gets the API key from the environment variable `GEMINI_API_KEY`.
const ai = new GoogleGenAI({});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Explain how AI works in a few words",
  });

  const modelStep = interaction.steps.find(s => s.type === 'model_output');
  if (modelStep) {
    for (const contentBlock of modelStep.content) {
      if (contentBlock.type === 'text') console.log(contentBlock.text);
    }
  }
}

main();

REST

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "Explain how AI works in a few words"
  }'

Étape suivante

Maintenant que vous avez effectué votre première requête d'API, vous pouvez consulter les guides suivants qui montrent Gemini en action :