คำอธิบายเวอร์ชัน API

เอกสารนี้แสดงภาพรวมระดับสูงเกี่ยวกับความแตกต่างระหว่าง 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."}]
    }]
   }'