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

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

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

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

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

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

from google import genai

client = genai.Client(api_key="YOUR_API_KEY",
                      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({
  apiKey: "YOUR_API_KEY",
  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?key=YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Explain how AI works."}]
    }]
   }'