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 modifications incompatibles, une nouvelle 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. L'API Interactions et ses principales fonctionnalités sont généralement disponibles dans v1.
• v1beta : cette version inclut des fonctionnalités et des capacités préliminaires en cours de développement. Bien que les fonctionnalités de v1beta puissent être modifiées à mesure que nous les affinons en fonction des commentaires, elles vous permettent d'essayer de nouvelles fonctionnalités avant qu'elles ne soient promues à la version stable.

Compatibilité des fonctionnalités

Le tableau suivant détaille la disponibilité des fonctionnalités dans v1 (DG) et v1beta (bêta). Les outils et les fonctionnalités de l'API Core s'appliquent à l'API Interactions et à generateContent, sauf indication contraire :

•  : compatible

Configurer la version de l'API dans un SDK

Les SDK de l'API Gemini sont définis par défaut sur v1beta, mais vous pouvez spécifier explicitement les 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': 'v1'})

interaction = client.interactions.create(
    model='gemini-3.6-flash',
    input="Explain how AI works",
)

print(interaction.output_text)

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

const ai = new GoogleGenAI({
  httpOptions: { apiVersion: "v1" },
});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.6-flash",
    input: "Explain how AI works",
  });
  console.log(interaction.output_text);
}

await main();

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