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 compatibles pendant toute la durée de vie de la version majeure. En cas de modifications incompatibles, la prochaine version majeure de l'API sera créée et la version existante sera obsolète après un délai raisonnable. Des modifications non destructives peuvent être apportées à l'API sans changer la version majeure.
• v1beta : cette version inclut des fonctionnalités préliminaires qui peuvent être en cours de développement et qui sont susceptibles d'entraîner des modifications incompatibles. De plus, rien ne garantit que les fonctionnalités de la version bêta seront intégrées à la version stable. Si vous avez besoin de stabilité dans votre environnement de production et que vous ne pouvez pas prendre le risque de changements cassants, vous ne devez pas utiliser cette version en production.

•  : compatible
•  : ne sera jamais compatible

Configurer la version de l'API dans un SDK

Le SDK de l'API Gemini utilise v1beta par défaut, mais vous pouvez choisir d'utiliser d'autres versions en définissant la version de l'API, comme indiqué dans l'exemple de code suivant :

from google import genai

client = genai.Client(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({
  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" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'