En este documento, se proporciona una descripción general de alto nivel sobre las diferencias entre las versiones v1
y v1beta de la API de Gemini.
- v1: Es la versión estable de la API. Las funciones de la versión estable son totalmente compatibles durante el ciclo de vida de la versión principal. Si hay algún cambio rotundo, se creará una nueva versión principal de la API y la versión existente dejará de estar disponible después de un período razonable.
Se pueden introducir cambios no rotundos en la API sin cambiar la versión principal. La API de Interactions y sus funciones principales están disponibles de forma general en
v1. - v1beta: Esta versión incluye funciones y capacidades iniciales que se están desarrollando de forma
activa. Si bien las funciones de
v1betapueden estar sujetas a cambios a medida que las perfeccionamos en función de los comentarios, te permiten probar nuevas capacidades antes de que se promuevan a la versión estable.
Compatibilidad con capacidades y funciones
En la siguiente tabla, se detalla la disponibilidad de las capacidades en v1 (DG)
y v1beta (Beta). Las capacidades y herramientas principales de la API se aplican a la API de Interactions y a generateContent, a menos que se especifique lo contrario:
- - Admitido
Configura la versión de la API en un SDK
Los SDKs de la API de Gemini usan v1beta de forma predeterminada, pero puedes especificar versiones de forma explícita configurando la versión de la API como se muestra en el siguiente ejemplo de código:
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",
}'