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

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