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

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

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

الإمكانات والميزات المتوافقة

يوضّح الجدول التالي مدى توفّر الإمكانات في الإصدارَين v1 (إصدار عام) و v1beta (إصدار تجريبي). تنطبق إمكانات وأدوات واجهة برمجة التطبيقات الأساسية على كلٍّ من Interactions API وgenerateContent ما لم يتم تحديد خلاف ذلك:

• - متاح

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

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

from google import genai

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

interaction = client.interactions.create(
    model='gemini-3.6-flash',
    input="Explain how AI works",
)

print(interaction.output_text)

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

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

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.6-flash",
    input: "Explain how AI works",
  });
  console.log(interaction.output_text);
}

await main();

curl -X POST "https://generativelanguage.googleapis.com/v1/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3.6-flash",
    "input": "Explain how AI works",
  }'