API sürümleriyle ilgili açıklama

Bu belgede, Gemini API'nin v1 ve v1beta sürümleri arasındaki farklara 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. Temel değişiklikler varsa API'nin bir sonraki ana sürümü oluşturulur ve makul bir sürenin ardından mevcut sürümün desteği sonlandırılır. Ana sürüm değiştirilmeden API'ye önemli olmayan değişiklikler eklenebilir.
• v1beta: Bu sürüm, geliştirme aşamasında olabilecek erken erişim özelliklerini içerir ve hızlı ve önemli değişikliklere tabidir. Ayrıca, beta sürümündeki özelliklerin kararlı sürüme taşınacağı garanti edilmez. Bu kararsızlık nedeniyle, bu sürümle üretim uygulamaları yayınlamamayı düşünmeniz önerilir.

• - Destekleniyor
• : 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(api_key="YOUR_API_KEY",
                      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({
  apiKey: "YOUR_API_KEY",
  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?key=YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'