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 dapat menyebabkan gangguan, versi utama API baru akan dibuat dan versi yang ada akan dihentikan setelah jangka waktu yang wajar. Perubahan yang tidak menyebabkan gangguan dapat diperkenalkan ke API tanpa mengubah versi utama. Interactions API dan fitur intinya umumnya tersedia di v1.
• v1beta: Versi ini mencakup fitur dan kemampuan awal yang sedang aktif dikembangkan. Meskipun fitur di v1beta dapat berubah saat kami menyempurnakannya berdasarkan masukan, fitur ini memungkinkan Anda mencoba kemampuan baru sebelum dipromosikan ke versi stabil.

Dukungan kemampuan dan fitur

Tabel berikut menjelaskan ketersediaan kemampuan di seluruh v1 (GA) dan v1beta (Beta). Kemampuan dan alat API inti berlaku untuk Interactions API dan generateContent, kecuali jika ditentukan lain:

• - Didukung

Mengonfigurasi versi API di SDK

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

from google import genai

client = genai.Client(http_options={'api_version': 'v1'})

interaction = client.interactions.create(
    model='gemini-3.6-flash',
    input="Explain how AI works",
)

print(interaction.output_text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  httpOptions: { apiVersion: "v1" },
});

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.6-flash",
    input: "Explain how AI works",
  });
  console.log(interaction.output_text);
}

await main();

curl -X POST "https://generativelanguage.googleapis.com/v1/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3.6-flash",
    "input": "Explain how AI works",
  }'