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

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

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

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

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

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

from google import genai

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

response = client.models.generate_content(
    model='gemini-2.0-flash',
    contents="Explain how AI works",
)

print(response.text)

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

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

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.0-flash",
    contents: "Explain how AI works",
  });
  console.log(response.text);
}

await main();

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