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

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

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

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

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

پایتون

Python SDK، google.generativeai ، از v1beta استفاده می کند و روشی برای تغییر نسخه API ارائه نمی دهد.

کتابخانه سرویس گیرنده پایتون سطح پایین، google.ai.generativelanguage نسخه های دیگر را به عنوان ماژول های جداگانه نشان می دهد: google.ai.generativelanguage_v1 و google.ai.generativelanguage_v1beta . پیش فرض v1beta است.

import google.ai.generativelanguage_v1 as glm

client = glm.GenerativeServiceClient(
    client_options=dict(api_key=YOUR_API_KEY))

response = client.generate_content({
  "model": "models/gemini-1.5-flash",
  "contents": [ {"parts": [ {"text": "Explain how AI works"}]}]
})

print(type(response).to_dict(response))

Node.js

const { GoogleGenerativeAI } = require("@google/generative-ai");

const genAI = new GoogleGenerativeAI("YOUR_API_KEY");
const model = genAI.getGenerativeModel({ model: 'gemini-1.5-flash' }, { apiVersion: 'v1' });

const prompt = "Explain how AI works";

const result = await model.generateContent(prompt);
console.log(result.response.text());

استراحت

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": "Write a story about a magic backpack."}]
    }]
   }'