این سند یک نمای کلی از تفاوتهای نسخه v1
و v1beta
Gemini API ارائه میکند.
- v1 : نسخه پایدار API. ویژگیهای نسخه پایدار در طول عمر نسخه اصلی به طور کامل پشتیبانی میشوند. اگر تغییرات قطعی وجود داشته باشد، نسخه اصلی بعدی API ایجاد خواهد شد و نسخه موجود پس از مدت زمان معقولی منسوخ خواهد شد. تغییرات غیرقابل تغییر ممکن است بدون تغییر نسخه اصلی به API ارائه شوند.
- v1beta : این نسخه شامل ویژگی های دسترسی اولیه است که ممکن است در دست توسعه باشد و در معرض تغییرات سریع و سریع است. همچنین هیچ تضمینی وجود ندارد که ویژگی های نسخه بتا به نسخه پایدار منتقل شوند. با توجه به این بی ثباتی، باید به فکر راه اندازی برنامه های تولیدی با این نسخه نباشید.
ویژگی | v1 | v1beta |
---|---|---|
تولید محتوا - ورودی فقط متنی | ||
تولید محتوا - ورودی متن و تصویر | ||
تولید محتوا - خروجی متن | ||
تولید محتوا - مکالمات چند نوبتی (چت) | ||
تولید محتوا - تماس های تابع | ||
تولید محتوا - پخش جریانی | ||
جاسازی محتوا - ورودی فقط متنی | ||
ایجاد پاسخ | ||
بازیابی معنایی |
- - پشتیبانی می شود
- - هرگز پشتیبانی نخواهد شد
نسخه API را در یک SDK پیکربندی کنید
Gemini API SDK پیشفرض v1beta
است، اما میتوانید با تنظیم نسخه api همانطور که در نمونه کد زیر نشان داده شده است، از v1
استفاده کنید:
پایتون
Python SDK، google.generativeai
، از v1beta
استفاده می کند و روشی برای تغییر نسخه API ارائه نمی دهد.
کتابخانه سرویس گیرنده پایتون سطح پایین، 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());
استراحت
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."}]
}]
}'