Bu belgede, Gemini API'nin v1
ve v1beta sürümleri arasındaki farklarla ilgili üst düzey bir genel bakış sunulmaktadır.
- v1: API'nin kararlı sürümü. Kararlı sürümdeki özellikler, ana sürümün kullanım ömrü boyunca tam olarak desteklenir. API'de herhangi bir uyumluluk sorunu oluşturan değişiklik varsa API'nin yeni bir ana sürümü oluşturulur ve mevcut sürüm makul bir süre sonra kullanımdan kaldırılır.
API'de ana sürüm değiştirilmeden uyumluluğu bozmayan değişiklikler yapılabilir. Etkileşimler API ve temel özellikleri,
v1'de genel kullanıma sunulmuştur. - v1beta: Bu sürüm, aktif olarak geliştirilmekte olan erken aşamadaki özellikleri ve işlevleri içerir.
v1betabölümündeki özellikler, geri bildirimlere göre iyileştirilirken değişikliklere tabi olabilir. Ancak bu bölüm, yeni özellikleri kararlı sürüme yükseltilmeden önce denemenize olanak tanır.
Özellik ve işlev desteği
Aşağıdaki tabloda, v1 (GA) ve v1beta (Beta) sürümlerindeki özelliklerin kullanılabilirliği ayrıntılı olarak açıklanmaktadır. Aksi belirtilmediği sürece temel API özellikleri ve araçları hem Interactions API hem de generateContent için geçerlidir:
| Özellik | v1 | v1beta |
|---|---|---|
| Temel API özellikleri | ||
| Interactions API | ||
| İşlev Çağrısı | ||
| Yapılandırılmış Çıkış (Structured Output) | ||
| Düşünme/Akıl Yürütme (Thinking / Reasoning) | ||
| Sistem Talimatları (System Instructions) | ||
| Ses Çıkışı (Konuşma Yapılandırması) | ||
| Hizmet Katmanı (Öncelikli / Esnek) | ||
| Araçlar | ||
| Kod Yürütme Aracı | ||
| Google Arama Temellendirmesi | ||
| Google Haritalar Temellendirme | ||
| URL Bağlamı Aracı | ||
| Dosya Arama Aracı | ||
| Bilgisayar Kullanım Aracı | ||
| MCP Sunucuları Aracı | ||
| Anlık API'ler | ||
| Live API (WebSockets) | ||
| Live Music API | ||
| Kısa Ömürlü Jetonlar (Canlı API) | ||
| Platform API'leri | ||
| Models API | ||
| Dosya Hizmeti Rotası | ||
| Dosya Arama Mağazaları Rotası | ||
| Agents API | ||
| Webhooks API | ||
| Bağlamı Önbelleğe Alma |
- - Desteklenir
SDK'da API sürümünü yapılandırma
Gemini API SDK'ları varsayılan olarak v1beta sürümünü kullanır ancak aşağıdaki kod örneğinde gösterildiği gibi API sürümünü ayarlayarak sürümleri açıkça belirtebilirsiniz:
Python
from google import genai
client = genai.Client(http_options={'api_version': 'v1'})
interaction = client.interactions.create(
model='gemini-3.8-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.8-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(""));
Go
package main
import (
"context"
"fmt"
"log"
"google.golang.org/genai"
"google.golang.org/genai/interactions/models/interactions"
"google.golang.org/genai/interactions/models/operations"
)
func main() {
ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
HTTPOptions: genai.HTTPOptions{
APIVersion: "v1",
},
})
if err != nil {
log.Fatal(err)
}
res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
Model: interactions.Model("gemini-3.6-flash"),
Input: interactions.NewInteractionsInput("Explain how AI works"),
}),
})
if err != nil {
log.Fatal(err)
}
if res.Interaction.OutputText != nil {
fmt.Println(*res.Interaction.OutputText)
}
}
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.8-flash",
"input": "Explain how AI works",
}'