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

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

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

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

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

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

from google import genai

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

interaction = client.interactions.create(
    model='gemini-3.5-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.5-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.5-flash",
    "input": "Explain how AI works"
  }'