شرح إصدارات واجهة برمجة التطبيقات

يقدّم هذا المستند نظرة عامة شاملة على الاختلافات بين الإصدارَين v1 وv1beta من Gemini API.

• v1: إصدار ثابت من واجهة برمجة التطبيقات يتم دعم الميزات في الإصدار الثابت بالكامل على مدار عمر الإصدار الرئيسي. في حال حدوث أي تغييرات جذرية، سيتم إنشاء الإصدار الرئيسي التالي من واجهة برمجة التطبيقات، وسيكون الإصدار الحالي متوقّفًا نهائيًا بعد فترة زمنية معقولة. قد يتم إدخال تغييرات غير مُعيقة لواجهة برمجة التطبيقات بدون تغيير الإصدار العميق.
• v1beta: يتضمّن هذا الإصدار ميزات الاستخدام التجريبي التي قد تكون قيد تطوير ويخضَع لتغييرات سريعة وخطيرة. ولا يمكن أيضًا ضمان نقل الميزات المتوفرة في الإصدار التجريبي إلى الإصدار الثابت. بسبب عدم استقرار هذا الإصدار، ننصحك بعدم إطلاق التطبيقات المخصّصة للإصدار العلني باستخدامه.

• - متاح
• - لن تكون متاحة أبدًا

ضبط إصدار واجهة برمجة التطبيقات في حزمة تطوير البرامج (SDK)

الإعداد التلقائي لحزمة SDK لواجهة برمجة التطبيقات Gemini هو v1beta، ولكن يمكنك اختيار استخدام v1 بدلاً من ذلك من خلال ضبط إصدار واجهة برمجة التطبيقات كما هو موضّح في نموذج الرمز البرمجي التالي:

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))

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."}]
    }]
   }'