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

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

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

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

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

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

from google import genai

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

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

print(response.text)

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

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

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

await main();

curl "https://generativelanguage.googleapis.com/v1/models/gemini-3.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."}]
    }]
   }'