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 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 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ý. 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 chính.
• v1beta: Phiên bản này bao gồm các tính năng ban đầu có thể đang trong giai đoạn phát triển và có thể có các thay đổi làm gián đoạn. Ngoài ra, không có gì đảm bảo rằng các tính năng trong phiên bản thử nghiệm sẽ chuyển sang phiên bản ổn định. Nếu cần sự ổn định trong môi trường phát hành chính thức và không thể chấp nhận các thay đổi có thể gây lỗi, thì bạn không nên sử dụng phiên bản này trong bản phát hành chính thức.

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