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

يقدّم هذا المستند نظرة عامة شاملة على الاختلافات بين الإصدارين 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-flash-preview',
    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-flash-preview",
    contents: "Explain how AI works",
  });
  console.log(response.text);
}

await main();

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