API sürümleriyle ilgili açıklama

Bu belgede, Gemini API'nin v1 ve v1beta sürümleri arasındaki farklara dair genel bir 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 hızlı ve zarar veren değişikliklere tabi olan erken erişim özelliklerini içerir. Ayrıca beta sürümündeki özelliklerin kararlı sürüme taşınacağı da garanti edilmez. Bu kararsızlık nedeniyle, üretim uygulamalarını bu sürümle başlatmamayı düşünebilirsiniz.

• - 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 API sürümünü aşağıdaki kod örneğinde gösterildiği gibi ayarlayarak diğer sürümleri kullanmayı tercih edebilirsiniz:

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)

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

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