يقدّم هذا المستند نظرة عامة شاملة على الاختلافات بين الإصدارَين v1
وv1beta
من Gemini API.
- v1: إصدار ثابت من واجهة برمجة التطبيقات يتم دعم الميزات في الإصدار الثابت بالكامل على مدار عمر الإصدار الرئيسي. في حال حدوث أي تغييرات جذرية، سيتم إنشاء الإصدار الرئيسي التالي من واجهة برمجة التطبيقات، وسيكون الإصدار الحالي متوقّفًا نهائيًا بعد فترة زمنية معقولة. قد يتم إدخال تغييرات غير مُعيقة لواجهة برمجة التطبيقات بدون تغيير الإصدار العميق.
- v1beta: يتضمّن هذا الإصدار ميزات الاستخدام التجريبي التي قد تكون قيد تطوير ويخضَع لتغييرات سريعة وخطيرة. ولا يمكن أيضًا ضمان نقل الميزات المتوفرة في الإصدار التجريبي إلى الإصدار الثابت. بسبب هذا الأداء غير المستقر، ننصحك بعدم إطلاق التطبيقات المخصّصة للإصدار العلني باستخدام هذا الإصدار.
الميزة | v1 | v1beta |
---|---|---|
إنشاء محتوى - إدخال نص فقط | ||
إنشاء محتوى: إدخال نص وصورة | ||
إنشاء المحتوى - إخراج النص | ||
إنشاء محتوى: محادثات متعددة المقاطع (محادثة) | ||
إنشاء المحتوى - استدعاء الدوالّ | ||
إنشاء المحتوى - البث | ||
تضمين المحتوى: إدخال نص فقط | ||
إنشاء إجابة | ||
أداة استرجاع دلالي |
- - متاح
- - لن تكون متاحة أبدًا
ضبط إصدار واجهة برمجة التطبيقات في حزمة تطوير البرامج (SDK)
الإعداد التلقائي لحزمة SDK لواجهة برمجة التطبيقات Gemini هو v1beta
، ولكن يمكنك اختيار استخدام v1
بدلاً من ذلك
من خلال ضبط إصدار واجهة برمجة التطبيقات كما هو موضّح في نموذج الرمز البرمجي التالي:
Python
تستخدم حزمة SDK لبرنامج Python، google.generativeai
، v1beta
ولا تقدّم
طريقة لتبديل إصدار واجهة برمجة التطبيقات.
تعرض مكتبة برامج 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."}]
}]
}'