ملاحظات المطورين / تم التحقق من الوثائق في 2026-09-23
Google Gemini
نقطة نهاية واجهة برمجة التطبيقات والإعداد.
هذا مسار التوافق مع OpenAI، وليس واجهة generateContent الأصلية لـ Gemini. استخدم مفتاح واجهة برمجة تطبيقات Gemini ومعرف نموذج Gemini.
عنوان URL الأساسي لمجموعة تطوير البرامج (SDK)
https://generativelanguage.googleapis.com/v1beta/openaiنقطة نهاية الطلب الكاملة · POST
https://generativelanguage.googleapis.com/v1beta/openai/chat/completionsاقرأ الوثائق الرسمية لـ Google Gemini ↗ · تم التحقق في 2026-09-23؛ لم يتم إجراء استدعاء مباشر لواجهة برمجة التطبيقات.
نقطة انطلاق صغيرة.
ثبّت المكتبة الموضحة أدناه. اضبط AI_MODEL على نموذج متاح لحسابك و GEMINI_API_KEY على مفتاحك. في cURL، استبدل YOUR_MODEL_ID. استبدل أي عناصر نائبة لمساحة العمل قبل التشغيل.
Python
# pip install openai
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["GEMINI_API_KEY"],
base_url="https://generativelanguage.googleapis.com/v1beta/openai",
)
response = client.chat.completions.create(
model=os.environ["AI_MODEL"], messages=[{"role": "user", "content": "Hello!"}]
)
print(response)Node.js
// npm install openai
// Server-side Node.js; never expose API keys in a browser.
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.GEMINI_API_KEY,
baseURL: "https://generativelanguage.googleapis.com/v1beta/openai",
});
const response = await client.chat.completions.create({
"model": process.env.AI_MODEL,
"messages": [
{
"role": "user",
"content": "Hello!"
}
]
});
console.log(response);cURL
curl 'https://generativelanguage.googleapis.com/v1beta/openai/chat/completions' \
-H "Authorization: Bearer $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_MODEL_ID",
"messages": [
{
"role": "user",
"content": "Hello!"
}
]
}'قبل نقل هذا إلى بيئة الإنتاج.
تحقق من توافر النماذج، والفوترة، وحدود المعدل، والمعلمات المدعومة في وثائق الموفر. ابدأ بطلب صغير من الواجهة الخلفية (Backend). احفظ المفاتيح بعيداً عن JavaScript من جانب العميل وأنظمة التحكم في المصدر.
توضح هذه الأمثلة شكل الطلب والإعدادات. لا تختبر بيانات الاعتماد الخاصة بك ولا تضمن الوصول إلى نموذج معين.
قارن نقاط نهاية واجهات برمجة تطبيقات الذكاء الاصطناعي الأخرى →