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 uyumluluğu bozan değişiklikler 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 API'yi bozmayan değişiklikler yapılabilir. Etkileşimler API ve temel özellikleri
v1'da genel kullanıma sunulmuştur. - v1beta: Bu sürüm, aktif olarak geliştirilmekte olan erken aşamadaki özellikleri ve işlevleri içerir.
v1beta'daki özellikler, geri bildirimlere göre iyileştirilirken değişikliklere tabi olabilir. Ancak bu özellikler, kararlı sürüme yükseltilmeden önce yeni işlevleri denemenize olanak tanır.
Kapasite ve özellik 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 Etkileşimler API'si hem de generateContent için geçerlidir:
| Özellik | v1 | v1beta |
|---|---|---|
| Temel API özellikleri | ||
| Interactions API | ||
| İşlev Çağırma | ||
| Yapılandırılmış Çıkış | ||
| Düşünme / Muhakeme Etme (Thinking / Reasoning) | ||
| Sistem Talimatları | ||
| Ses çıkışı (konuşma yapılandırması) | ||
| Hizmet Katmanı (Öncelikli / Esnek) | ||
| Araçlar | ||
| Kod Yürütme Aracı | ||
| Google Arama Temellendirmesi | ||
| Google Haritalar'da Temellendirme (Google Maps Grounding) | ||
| 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.6-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.6-flash",
input: "Explain how AI works",
});
console.log(interaction.output_text);
}
await main();
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.6-flash",
"input": "Explain how AI works",
}'