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 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 ổn định. 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.
| Tính năng | v1 | v1beta |
|---|---|---|
| Tạo nội dung – Chỉ nhập văn bản | ||
| Tạo nội dung – Nhập văn bản và hình ảnh | ||
| Tạo nội dung – Đầu ra văn bản | ||
| Tạo nội dung – Cuộc trò chuyện nhiều lượt (trò chuyện) | ||
| Tạo nội dung – Lệnh gọi hàm | ||
| Tạo nội dung – Phát trực tuyến | ||
| Nhúng nội dung – Nhập chỉ văn bản | ||
| Tạo câu trả lời | ||
| Trình truy xuất ngữ nghĩa |
- – Đượ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 v1 bằng cách đặt phiên bản API như trong mã mẫu sau:
Python
SDK Python, google.generativeai, sử dụng v1beta và không cung cấp phương thức để chuyển đổi phiên bản API.
Thư viện ứng dụng Python cấp thấp, google.ai.generativelanguage hiển thị các phiên bản khác dưới dạng mô-đun riêng biệt: google.ai.generativelanguage_v1 và google.ai.generativelanguage_v1beta. Giá trị mặc định là v1beta.
import google.ai.generativelanguage_v1 as glm
client = glm.GenerativeServiceClient(
client_options=dict(api_key=YOUR_API_KEY))
response = client.generate_content({
"model": "models/gemini-1.5-flash",
"contents": [ {"parts": [ {"text": "Explain how AI works"}]}]
})
print(type(response).to_dict(response))
Node.js
const { GoogleGenerativeAI } = require("@google/generative-ai");
const genAI = new GoogleGenerativeAI("YOUR_API_KEY");
const model = genAI.getGenerativeModel({ model: 'gemini-1.5-flash' }, { apiVersion: 'v1' });
const prompt = "Explain how AI works";
const result = await model.generateContent(prompt);
console.log(result.response.text());
REST
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": "Write a story about a magic backpack."}]
}]
}'