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

يقدّم هذا المستند نظرة عامة شاملة على الاختلافات بين الإصدارَين 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."}]
    }]
   }'