Omówienie wersji interfejsu API

Ten dokument zawiera ogólne omówienie różnic między wersjami v1 i v1beta interfejsu Gemini API.

  • v1: stabilna wersja interfejsu API. Funkcje w wersji stabilnej są w pełni obsługiwane przez cały okres istnienia wersji głównej. Jeśli wystąpią jakiekolwiek zmiany powodujące niezgodność wsteczną, utworzymy kolejną główną wersję interfejsu API, a dotychczasowa wersja zostanie wycofana po upływie odpowiedniego czasu. W interfejsie API mogą zostać wprowadzone zmiany, które nie powodują problemów, bez zmiany głównej wersji.
  • v1beta: ta wersja zawiera funkcje w ramach wczesnego dostępu, które mogą być w trakcie opracowywania i mogą ulec szybkim zmianom powodującym niezgodność. Nie ma też gwarancji, że funkcje w wersji beta zostaną przeniesione do wersji stabilnej. Z powodu tej niestabilności nie zalecamy uruchamiania aplikacji produkcyjnych w tej wersji.
Funkcja v1 v1beta
Generowanie treści – dane wejściowe tylko w formie tekstu
Generowanie treści – dane wejściowe w postaci tekstu i obrazu
Generowanie treści – dane wyjściowe w postaci tekstu
Generowanie treści – rozmowy wieloetapowe (czat)
Generowanie treści – wywołania funkcji
Generowanie treści – streaming
Umieszczanie treści – wprowadzanie tylko tekstu
Wygeneruj odpowiedź
Wyszukiwarka semantyczna
  •  – obsługiwane
  •  – nigdy nie będzie obsługiwana

Konfigurowanie wersji interfejsu API w pakiecie SDK

Domyślna wersja pakietu SDK interfejsu Gemini API to v1beta, ale możesz używać innych wersji, ustawiając wersję interfejsu API w sposób pokazany w poniższym przykładowym kodzie:

Python

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)

JavaScript

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();

REST

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."}]
    }]
   }'