เอกสารนี้แสดงภาพรวมระดับสูงเกี่ยวกับความแตกต่างระหว่าง Gemini API เวอร์ชัน v1
กับ v1beta
- v1: API เวอร์ชันเสถียร ฟีเจอร์ในเวอร์ชันเสถียรจะได้รับการรองรับอย่างเต็มรูปแบบตลอดอายุการใช้งานของเวอร์ชันหลัก หากมีการเปลี่ยนแปลงที่สำคัญ ระบบจะสร้าง API เวอร์ชันหลักเวอร์ชันถัดไปและเลิกใช้งานเวอร์ชันที่มีอยู่หลังจากผ่านไประยะเวลาหนึ่ง เราอาจเปิดตัวการเปลี่ยนแปลงที่ไม่ก่อให้เกิดข้อขัดข้องใน API โดยไม่ต้องเปลี่ยนเวอร์ชันหลัก
- v1beta: เวอร์ชันนี้มีฟีเจอร์ทดลองใช้ก่อนเปิดตัวที่อาจอยู่ระหว่างการพัฒนาและอาจมีการเปลี่ยนแปลงอย่างรวดเร็วและส่งผลกับส่วนอื่นในระบบ นอกจากนี้ เราไม่สามารถรับประกันได้ว่าฟีเจอร์ในเวอร์ชันเบต้าจะย้ายไปยังเวอร์ชันเสถียร คุณจึงควรพิจารณาไม่เปิดตัวแอปพลิเคชันเวอร์ชันที่ใช้งานจริงด้วยเวอร์ชันนี้เนื่องจากความไม่เสถียรนี้
ฟีเจอร์ | v1 | v1beta |
---|---|---|
สร้างเนื้อหา - การป้อนเฉพาะข้อความ | ||
สร้างเนื้อหา - อินพุตข้อความและรูปภาพ | ||
สร้างเนื้อหา - เอาต์พุตข้อความ | ||
สร้างเนื้อหา - การสนทนาแบบหลายรอบ (แชท) | ||
สร้างเนื้อหา - การเรียกใช้ฟังก์ชัน | ||
สร้างเนื้อหา - สตรีมมิง | ||
ฝังเนื้อหา - การป้อนเฉพาะข้อความ | ||
สร้างคำตอบ | ||
เครื่องมือดึงข้อมูลเชิงความหมาย |
- - รองรับ
- - จะไม่รองรับ
กำหนดค่าเวอร์ชัน API ใน SDK
ค่าเริ่มต้นของ Gemini API SDK คือ v1beta
แต่คุณเลือกที่จะใช้ v1
แทนได้ โดยการตั้งค่าเวอร์ชัน API ตามที่แสดงในตัวอย่างโค้ดต่อไปนี้
Python
SDK ของ Python อย่าง google.generativeai
ใช้ v1beta
และไม่มีวิธีเปลี่ยนเวอร์ชัน API
ไลบรารีของไคลเอ็นต์ Python ระดับล่างอย่าง google.ai.generativelanguage
จะแสดงเวอร์ชันอื่นๆ เป็นโมดูลแยกต่างหาก ได้แก่ google.ai.generativelanguage_v1
และ google.ai.generativelanguage_v1beta
ค่าเริ่มต้นคือ 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."}]
}]
}'