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

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

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

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

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

Python

from google import genai

client = genai.Client(api_key="YOUR_API_KEY",
                      http_options={'api_version': 'v1alpha'})

response = client.models.generate_content(
    model='gemini-2.0-flash',
    contents="Explain how AI works",
)

print(response.text)

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": "Explain how AI works."}]
    }]
   }'