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 API Gemini.

• 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 hoạt động của phiên bản chính. Nếu có bất kỳ thay đổi nào gây lỗi, 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ẽ ngừng hoạt động 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 sử dụng sớm có thể đang trong quá trình phát triển và có thể thay đổi nhanh chóng và gây lỗi. Ngoài ra, chúng tôi không đả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 chính thức. Do sự không ổn định này, bạn nên cân nhắc không chạy các ứng dụng phát hành chính thức 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

SDK API Gemini 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ã mẫu sau:

from google import genai

client = genai.Client(api_key="YOUR_API_KEY",
                      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({
  apiKey: "YOUR_API_KEY",
  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?key=YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'