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 menyebabkan gangguan, versi utama baru API 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 tersedia secara umum di
v1. - v1beta: Versi ini mencakup fitur dan kemampuan awal yang sedang dikembangkan secara aktif. Meskipun fitur di
v1betadapat mengalami perubahan saat kami menyempurnakannya berdasarkan masukan, fitur ini memungkinkan Anda mencoba kemampuan baru sebelum dipromosikan ke versi stabil.
Dukungan kemampuan dan fitur
Tabel berikut menguraikan ketersediaan kemampuan di 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
SDK Gemini API secara default menggunakan v1beta, tetapi Anda dapat menentukan versi secara eksplisit dengan menyetel versi API seperti yang ditunjukkan dalam contoh kode berikut:
Python
from google import genai
client = genai.Client(http_options={'api_version': 'v1'})
interaction = client.interactions.create(
model='gemini-3.8-flash',
input="Explain how AI works",
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({
httpOptions: { apiVersion: "v1" },
});
async function main() {
const interaction = await ai.interactions.create({
model: "gemini-3.8-flash",
input: "Explain how AI works",
});
console.log(interaction.output_text);
}
await main();
Java
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
import com.google.genai.types.HttpOptions;
Client client = Client.builder()
.httpOptions(HttpOptions.builder().apiVersion("v1").build())
.build();
CreateModelInteraction req = CreateModelInteraction.builder()
.model(Model.of("gemini-3.6-flash"))
.input(InteractionsInput.of("Explain how AI works"))
.build();
var interaction = client.interactions.create(CreateInteractionRequestBody.of(req)).interaction().get();
System.out.println(interaction.outputText().orElse(""));
Go
package main
import (
"context"
"fmt"
"log"
"google.golang.org/genai"
"google.golang.org/genai/interactions/models/interactions"
"google.golang.org/genai/interactions/models/operations"
)
func main() {
ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig{
HTTPOptions: genai.HTTPOptions{
APIVersion: "v1",
},
})
if err != nil {
log.Fatal(err)
}
res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
Model: interactions.Model("gemini-3.6-flash"),
Input: interactions.NewInteractionsInput("Explain how AI works"),
}),
})
if err != nil {
log.Fatal(err)
}
if res.Interaction.OutputText != nil {
fmt.Println(*res.Interaction.OutputText)
}
}
REST
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.8-flash",
"input": "Explain how AI works",
}'