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 radicales, 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 radicales peuvent être apportées à l'API sans modifier la version majeure. L'API Interactions et ses fonctionnalités principales sont généralement disponibles dans
v1. - v1beta : cette version inclut des fonctionnalités et des capacités précoces en cours de développement
actif. Bien que les fonctionnalités de
v1betapuissent être sujettes à des modifications à mesure que nous les affinons en fonction des commentaires, elles vous permettent d'essayer de nouvelles fonctionnalités avant qu'elles ne soient promues en version stable.
Compatibilité des fonctionnalités et des capacités
Le tableau suivant détaille la disponibilité des capacités dans v1 (disponibilité générale)
et v1beta (bêta). Les outils et capacités d'API de base 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 des versions en définissant la version de l'API, comme indiqué dans l'exemple de code suivant :
Python
from google import genai
client = genai.Client(http_options={'api_version': 'v1'})
interaction = client.interactions.create(
model='gemini-3.7-flash',
input="Explain how AI works",
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({
httpOptions: { apiVersion: "v1" },
});
async function main() {
const interaction = await ai.interactions.create({
model: "gemini-3.7-flash",
input: "Explain how AI works",
});
console.log(interaction.output_text);
}
await main();
Java
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
import com.google.genai.types.HttpOptions;
Client client = Client.builder()
.httpOptions(HttpOptions.builder().apiVersion("v1").build())
.build();
CreateModelInteraction req = CreateModelInteraction.builder()
.model(Model.of("gemini-3.6-flash"))
.input(InteractionsInput.of("Explain how AI works"))
.build();
var interaction = client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));
REST
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.7-flash",
"input": "Explain how AI works",
}'