API sürümleriyle ilgili açıklama

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'nin bir sonraki ana sürümü, mevcut sürümde herhangi bir uyumluluk sorunu oluşturacak değişiklik varsa 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. Haziran 2026 itibarıyla Interactions API, genel kullanıma sunulmuş ve v1'da desteklenmektedir.
• v1beta: Bu sürüm, geliştirilme süreci devam eden 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.

• - Desteklenir
• - Hiçbir zaman desteklenmeyecek

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:

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