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 vòng đờ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 có sẽ không được dùng nữa sau một khoảng thời gian hợp lý. Bạn có thể đưa các thay đổi không gây lỗi vào API mà không cần thay đổi phiên bản chính.
• v1beta: Phiên bản này bao gồm các tính năng ban đầu có thể đang trong quá trình phát triển và có thể bị thay đổi gây lỗi. Ngoài ra, không có gì đảm bảo rằng các tính năng trong phiên bản Beta sẽ chuyển sang phiên bản ổn định. Nếu bạn cần tính ổn định trong môi trường thực tế và không thể chấp nhận rủi ro về các thay đổi gây lỗi, thì bạn không nên sử dụng phiên bản này trong quá trình sản xuất.

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

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

SDK Gemini API mặc định là v1beta, nhưng bạn có thể chỉ định phiên bản một cách rõ ràng 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'})

response = client.models.generate_content(
    model='gemini-3.5-flash',
    contents="Explain how AI works",
)

print(response.text)

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

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

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3.5-flash",
    contents: "Explain how AI works",
  });
  console.log(response.text);
}

await main();

curl "https://generativelanguage.googleapis.com/v1/models/gemini-3.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."}]
    }]
   }'