نسخه های API توضیح داده شده است

این سند یک مرور کلی سطح بالا از تفاوت‌های بین نسخه‌های v1 و v1beta از رابط برنامه‌نویسی Gemini ارائه می‌دهد.

• v1 : نسخه پایدار API. ویژگی‌های موجود در نسخه پایدار در طول عمر نسخه اصلی کاملاً پشتیبانی می‌شوند. در صورت وجود هرگونه تغییر اساسی، نسخه اصلی بعدی API ایجاد می‌شود و نسخه موجود پس از مدت زمان معقولی منسوخ می‌شود. تغییرات اساسی ممکن است بدون تغییر نسخه اصلی به API اضافه شوند. از ژوئن 2026، API تعاملات به طور کلی در v1 در دسترس و پشتیبانی می‌شود.
• نسخه v1beta : این نسخه شامل ویژگی‌ها و قابلیت‌های اولیه‌ای است که به طور فعال در حال توسعه هستند. اگرچه ویژگی‌های v1beta ممکن است در حین اصلاح بر اساس بازخوردها، دستخوش تغییراتی شوند، اما به شما امکان می‌دهد قابلیت‌های جدید را قبل از ارتقاء به نسخه پایدار، امتحان کنید.

• - پشتیبانی شده
• - هرگز پشتیبانی نخواهد شد

پیکربندی نسخه API در SDK

کیت‌های توسعه نرم‌افزار Gemini API به طور پیش‌فرض روی v1beta تنظیم شده‌اند، اما می‌توانید با تنظیم نسخه API، همانطور که در نمونه کد زیر نشان داده شده است، نسخه‌ها را به صراحت مشخص کنید:

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"
  }'