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ü, önemli değişiklikler 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 uyumluluğu bozmayan değişiklikler yapılabilir.
• v1beta: Bu sürüm, geliştirme aşamasında olabilecek ve zarar veren değişikliklere tabi olabilecek erken özellikler içerir. Beta sürümündeki özelliklerin kararlı sürüme taşınacağı da garanti edilmez. Üretim ortamınızda kararlılık gerekiyorsa ve değişikliklerin bozulma riskini göze alamıyorsanız bu sürümü üretimde kullanmamalısınız.

• - Desteklenir
• - Hiçbir zaman desteklenmeyecek

SDK'da API sürümünü yapılandırma

Gemini API SDK'sı 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 diğer sürümleri kullanmayı tercih edebilirsiniz:

from google import genai

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

response = client.models.generate_content(
    model='gemini-3-flash-preview',
    contents="Explain how AI works",
)

print(response.text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  httpOptions: { apiVersion: "v1" },
});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3-flash-preview",
    contents: "Explain how AI works",
  });
  console.log(response.text);
}

await main();

curl "https://generativelanguage.googleapis.com/v1/models/gemini-3-flash-preview:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'