Giải thích về các phiên bản API

Tài liệu này cung cấp thông tin tổng quan cấp cao về những điểm khác biệt giữa phiên bản v1 và v1beta của Gemini API.

• v1: Phiên bản ổn định của API. Các tính năng trong phiên bản ổn định được hỗ trợ đầy đủ trong suốt thời gian tồn tại của phiên bản lớn. Nếu có bất kỳ thay đổi có thể gây lỗi nào, thì phiên bản lớn tiếp theo của API sẽ được tạo và phiên bản hiện tại sẽ không được dùng nữa sau một khoảng thời gian hợp lý. Các thay đổi không làm gián đoạn có thể được giới thiệu cho API mà không làm thay đổi phiên bản lớn. Kể từ tháng 6 năm 2026, Interactions API sẽ được cung cấp rộng rãi và được hỗ trợ trong v1.
• v1beta: Phiên bản này bao gồm các tính năng và chức năng ban đầu đang được phát triển tích cực. Mặc dù các tính năng trong v1beta có thể thay đổi khi chúng tôi tinh chỉnh dựa trên ý kiến phản hồi, nhưng bạn có thể dùng thử các tính năng mới trước khi chúng được chuyển sang phiên bản ổn định.

• – Được hỗ trợ
• – Sẽ không bao giờ được hỗ trợ

Định cấu hình phiên bản API trong SDK

Các SDK của Gemini API mặc định là v1beta, nhưng bạn có thể chỉ định rõ ràng các phiên bản bằng cách đặt phiên bản API như trong mẫu mã sau:

from google import genai

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

interaction = client.interactions.create(
    model='gemini-3.5-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.5-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.5-flash",
    "input": "Explain how AI works"
  }'