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.
| Özellik | v1 | v1beta |
|---|---|---|
| İçerik Oluşturma - Yalnızca metin girişi | ||
| İçerik Oluşturma - Metin ve resim girişi | ||
| İçerik Oluşturma - Metin çıkışı | ||
| İçerik Oluşturma - Çoklu katılımlı görüşmeler (sohbet) | ||
| İçerik Oluşturma - İşlev çağrıları | ||
| İçerik Oluşturma - Akış | ||
| İçerik yerleştirme - Yalnızca metin girişi | ||
| Yanıt Oluştur | ||
| Semantik Retriever |
- - Destekleniyor
- : Hiçbir zaman desteklenmeyecek
SDK'da API sürümünü yapılandırma
Gemini API SDK'sı varsayılan olarak v1beta değerini kullanır ancak API sürümünü aşağıdaki kod örneğinde gösterildiği gibi ayarlayarak bunun yerine v1 kullanmayı tercih edebilirsiniz:
Python
google.generativeai adlı Python SDK'sı v1beta'u kullanır ve API sürümünü değiştirmek için bir yöntem sağlamaz.
Düşük düzey Python istemci kitaplığı google.ai.generativelanguage, diğer sürümleri ayrı modüller olarak gösterir: google.ai.generativelanguage_v1 ve google.ai.generativelanguage_v1beta. Varsayılan değer v1beta'tir.
import google.ai.generativelanguage_v1 as glm
client = glm.GenerativeServiceClient(
client_options=dict(api_key=YOUR_API_KEY))
response = client.generate_content({
"model": "models/gemini-1.5-flash",
"contents": [ {"parts": [ {"text": "Explain how AI works"}]}]
})
print(type(response).to_dict(response))
Node.js
const { GoogleGenerativeAI } = require("@google/generative-ai");
const genAI = new GoogleGenerativeAI("YOUR_API_KEY");
const model = genAI.getGenerativeModel({ model: 'gemini-1.5-flash' }, { apiVersion: 'v1' });
const prompt = "Explain how AI works";
const result = await model.generateContent(prompt);
console.log(result.response.text());
REST
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": "Write a story about a magic backpack."}]
}]
}'