سازگاری OpenAI

مدل‌های Gemini با استفاده از کتابخانه‌های OpenAI (پایتون و تایپ‌اسکریپت / جاوااسکریپت) به همراه REST API، با به‌روزرسانی سه خط کد و استفاده از کلید API Gemini شما، قابل دسترسی هستند. اگر قبلاً از کتابخانه‌های OpenAI استفاده نمی‌کردید، توصیه می‌کنیم مستقیماً API Gemini را فراخوانی کنید.

پایتون 

from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

response = client.chat.completions.create(
    model="gemini-3.7-flash",
    messages=[
        {   "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "Explain to me how AI works"
        }
    ]
)

print(response.choices[0].message)

جاوا اسکریپت 

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "GEMINI_API_KEY",
    baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/"
});

const response = await openai.chat.completions.create({
    model: "gemini-3.7-flash",
    messages: [
        {   role: "system",
            content: "You are a helpful assistant." 
        },
        {
            role: "user",
            content: "Explain to me how AI works",
        },
    ],
});

console.log(response.choices[0].message);

استراحت 

curl "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $GEMINI_API_KEY" \
  -d '{
    "model": "gemini-3.7-flash",
    "messages": [
      {
        "role": "user",
        "content": "Explain to me how AI works"
      }
    ]
  }'

چه چیزی تغییر کرد؟ فقط سه خط!

  • api_key="GEMINI_API_KEY" : عبارت " GEMINI_API_KEY " را با کلید API واقعی Gemini خود که می‌توانید از Google AI Studio دریافت کنید، جایگزین کنید.

  • base_url="https://generativelanguage.googleapis.com/v1beta/openai/" : این به کتابخانه OpenAI می‌گوید که درخواست‌ها را به جای URL پیش‌فرض، به نقطه پایانی Gemini API ارسال کند.

  • model="gemini-3.7-flash" : یک مدل سازگار با Gemini را انتخاب کنید

تفکر

مدل‌های Gemini برای تفکر در مورد مسائل پیچیده آموزش دیده‌اند که منجر به بهبود قابل توجه استدلال می‌شود. API Gemini دارای پارامترهای تفکر است که کنترل دقیقی بر میزان تفکر مدل ارائه می‌دهد.

مدل‌های مختلف Gemini پیکربندی‌های استدلال متفاوتی دارند، می‌توانید نحوه‌ی نگاشت آن‌ها به تلاش‌های استدلال OpenAI را به صورت زیر مشاهده کنید:

reasoning_effort (OpenAI) thinking_level (Gemini 3.1 Pro) thinking_level (Gemini 3.1 Flash-Lite) thinking_level (جمینی ۳ فلش) thinking_budget (جمینی ۲.۵)
minimal low minimal minimal 1,024
low low low low 1,024
medium medium medium medium 8,192
high high high high 24,576

اگر هیچ reasoning_effort مشخص نشده باشد، Gemini از سطح یا budget پیش‌فرض مدل استفاده می‌کند.

اگر می‌خواهید قابلیت تفکر را غیرفعال کنید، می‌توانید برای مدل‌های ۲.۵، reasoning_effort روی "none" تنظیم کنید. برای مدل‌های Gemini 2.5 Pro یا ۳، قابلیت Reasoning را نمی‌توان غیرفعال کرد.

پایتون 

from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

response = client.chat.completions.create(
    model="gemini-3.7-flash",
    reasoning_effort="low",
    messages=[
        {   "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "Explain to me how AI works"
        }
    ]
)

print(response.choices[0].message)

جاوا اسکریپت 

import OpenAI from "openai"