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 chính. Nếu có bất kỳ thay đổi nào mang tính đột phá, thì phiên bản chính 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ể giới thiệu các thay đổi không làm gián đoạn cho 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 truy cập sớm có thể đang trong quá trình phát triển và có thể có những thay đổi đột ngột và mang tính phá vỡ. 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. Do tính không ổn định này, bạn nên cân nhắc việc không chạy các ứng dụng phát hành công khai bằng phiên bản này.

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

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

Gemini API SDK mặc định là v1beta, nhưng bạn có thể chọn sử dụng các phiên bản khác 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': 'v1alpha'})

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

print(response.text)

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

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

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

await main();

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