Versi API dijelaskan

Dokumen ini memberikan ringkasan umum tentang perbedaan antara versi v1 dan v1beta Gemini API.

• v1: Versi API yang stabil. Fitur dalam versi stabil didukung sepenuhnya selama masa aktif versi utama. Jika ada perubahan yang merusak, maka versi utama API berikutnya akan dibuat dan versi yang ada akan dihentikan setelah jangka waktu yang wajar. Perubahan yang tidak merusak dapat diperkenalkan ke API tanpa mengubah versi utama.
• v1beta: Versi ini mencakup fitur awal yang mungkin masih dalam pengembangan dan dapat mengalami perubahan yang menyebabkan gangguan. Selain itu, tidak ada jaminan bahwa fitur dalam versi Beta akan dipindahkan ke versi stabil. Jika Anda memerlukan stabilitas di lingkungan produksi dan tidak dapat mengambil risiko perubahan yang merusak, Anda tidak boleh menggunakan versi ini dalam produksi.

• - Didukung
• - Tidak akan pernah didukung

Mengonfigurasi versi API di SDK

Gemini API SDK secara default menggunakan v1beta, tetapi Anda dapat memilih untuk menggunakan versi lain dengan menetapkan versi API seperti yang ditunjukkan dalam contoh kode berikut:

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