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

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

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

• ‫ - متوافق
• ‫ - لن يكون متاحًا أبدًا

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

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

from google import genai

client = genai.Client(http_options={'api_version': 'v1alpha'})

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

print(response.text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  httpOptions: { apiVersion: "v1alpha" },
});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.0-flash",
    contents: "Explain how AI works",
  });
  console.log(response.text);
}

await main();

curl "https://generativelanguage.googleapis.com/v1/models/gemini-1.5-flash:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'