Объяснение версий API

В этом документе представлен общий обзор различий между версиями v1 и v1beta API Gemini.

• v1 : Стабильная версия API. Функции стабильной версии полностью поддерживаются на протяжении всего срока службы основной версии. В случае внесения каких-либо критических изменений будет создана следующая основная версия API, а существующая версия будет объявлена ​​устаревшей по истечении разумного периода времени. В API могут быть внесены изменения, не нарушающие обратную совместимость, без изменения основной версии. По состоянию на июнь 2026 года API взаимодействий является общедоступным и поддерживается в v1 .
• v1beta : Эта версия включает в себя ранние функции и возможности, которые активно разрабатываются. Хотя функции в v1beta могут быть изменены по мере их доработки на основе отзывов, она позволяет вам опробовать новые возможности до того, как они будут включены в стабильную версию.

• - Поддерживается
• - Никогда не будет поддержано

Настройка версии API в SDK

В SDK API Gemini по умолчанию используется версия v1beta , но вы можете явно указать версию, задав версию API, как показано в следующем примере кода:

from google import genai

client = genai.Client(http_options={'api_version': 'v1'})

interaction = client.interactions.create(
    model='gemini-3.5-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.5-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.5-flash",
    "input": "Explain how AI works"
  }'