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ề sự khác biệt giữa các 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, một phiên bản lớn mới của API sẽ được tạo và phiên bản hiện có sẽ bị ngừng hoạt động 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. Interactions API và các tính năng cốt lõi của API này thường có 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.

Khả năng và phạm vi hỗ trợ tính năng

Bảng sau đây trình bày chi tiết về khả năng sử dụng các tính năng trên v1 (GA) và v1beta (Beta). Các công cụ và chức năng API cốt lõi áp dụng cho cả Interactions API và generateContent, trừ phi có quy định khác:

• – Đượ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.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",
  }'