Présentation des versions de l'API

Ce document offre une vue d'ensemble des différences entre les versions v1 et v1beta de l'API Gemini.

• v1: version stable de l'API. Les fonctionnalités de la version stable sont entièrement prises en charge pendant toute la durée de vie de la version majeure. En cas de modification importante, la prochaine version majeure de l'API sera créée et la version existante sera abandonnée après un délai raisonnable. Des modifications non destructives peuvent être apportées à l'API sans modifier la version majeure.
• v1beta: cette version inclut des fonctionnalités en accès anticipé qui peuvent être en cours de développement et est sujette à des modifications rapides et destructives. Il n'est pas non plus garanti que les fonctionnalités de la version bêta seront transférées vers la version stable. En raison de cette instabilité, nous vous conseillons de ne pas lancer d'applications de production avec cette version.

•  : compatible
•  : jamais compatible

Configurer la version de l'API dans un SDK

La valeur par défaut du SDK de l'API Gemini est v1beta, mais vous pouvez choisir d'utiliser d'autres versions en définissant la version de l'API, comme illustré dans l'exemple de code suivant:

from google import genai

client = genai.Client(api_key="YOUR_API_KEY",
                      http_options={'api_version': 'v1alpha'})

response = client.models.generate_content(
    model='gemini-2.0-flash',
    contents="Explain how AI works",
)

print(response.text)

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

const ai = new GoogleGenAI({
  apiKey: "YOUR_API_KEY",
  httpOptions: { apiVersion: "v1alpha" },
});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.0-flash",
    contents: "Explain how AI works",
  });
  console.log(response.text);
}

await main();

curl "https://generativelanguage.googleapis.com/v1/models/gemini-1.5-flash:generateContent?key=YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'