Dokumen ini memberikan ringkasan umum tentang perbedaan antara versi Gemini API v1
dan v1beta.
- v1: Versi API yang stabil. Fitur dalam versi stabil didukung sepenuhnya selama masa aktif versi utama. Jika ada perubahan yang menyebabkan error, versi utama API berikutnya akan dibuat dan versi yang ada tidak akan digunakan lagi setelah jangka waktu yang wajar. Perubahan yang tidak menyebabkan gangguan dapat diperkenalkan ke API tanpa mengubah versi utama.
- v1beta: Versi ini menyertakan fitur akses awal yang mungkin sedang dalam pengembangan dan dapat mengalami perubahan yang cepat dan merusak. Tidak ada jaminan bahwa fitur dalam versi Beta akan dipindahkan ke versi stabil. Karena ketidakstabilan ini, sebaiknya Anda tidak meluncurkan aplikasi produksi dengan versi ini.
| Fitur | v1 | v1beta |
|---|---|---|
| Buat Konten - Input khusus teks | ||
| Buat Konten - Input teks dan gambar | ||
| Buat Konten - Output teks | ||
| Membuat Konten - Percakapan multi-giliran (chat) | ||
| Membuat Konten - Panggilan fungsi | ||
| Membuat Konten - Streaming | ||
| Menyematkan Konten - Input khusus teks | ||
| Buat Jawaban | ||
| Pengambil semantik |
- - Didukung
- - Tidak akan pernah didukung
Mengonfigurasi versi API di SDK
Gemini API SDK secara default menggunakan v1beta, tetapi Anda dapat memilih untuk menggunakan v1
dengan menetapkan versi API seperti yang ditunjukkan dalam contoh kode berikut:
Python
Python SDK, google.generativeai, menggunakan v1beta dan tidak menyediakan
metode untuk beralih versi API.
Library klien Python tingkat rendah, google.ai.generativelanguage mengekspos
versi lain sebagai modul terpisah: google.ai.generativelanguage_v1 dan
google.ai.generativelanguage_v1beta. Nilai default-nya adalah v1beta.
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."}]
}]
}'