ما الذي ستبنيه
سترسل طلب Gemini أصليًا إلىPOST /v1beta/models/\{model\}:generateContent، ثم تقارنه بخيار POST /v1/chat/completions المتوافق مع OpenAI للتطبيقات التي تستخدم بالفعل بنية طلبات Chat Completions.
المتطلبات المسبقة
- مفتاح API من CometAPI مخزَّن في
COMETAPI_KEY - model ID لنموذج Gemini نصي من صفحة النماذج
curlأو Python 3.10+ أو Node.js 18+
مفتاح API وعنوان URL الأساسي والمصادقة
استخدم endpoint الأصلي لـ Gemini عندما تريد حقول طلب Gemini:x-goog-api-key لطلبات HTTP الأصلية المباشرة لـ Gemini:
تنسيق Gemini الأصلي
تستخدم طلبات Gemini الأصليةcontents وparts وgenerationConfig. استخدم هذا المسار عندما تحتاج إلى حقول خاصة بـ Gemini مثل عناصر التحكم في التفكير، وأجزاء الوسائط، وGoogle Search grounding، أو عوامل Streaming الأصلية.
الخيار المتوافق مع OpenAI
استخدم المسار المتوافق مع OpenAI عندما تكون بصدد ترحيل OpenAI SDK موجود أو تطبيق Chat Completions قائم، ولا تحتاج إلى حقول طلب Gemini الأصلية.شرح التدفق
لا تخلط بين تنسيقي الطلبين. حقول Gemini الأصلية مثل
contents وgenerationConfig تنتمي إلى مسار generateContent. أما حقول Chat Completions مثل messages فتنتمي إلى المسار المتوافق مع OpenAI.
استكشاف الأخطاء وإصلاحها / الأسئلة الشائعة
أي مسار يجب أن أبدأ به
أي مسار يجب أن أبدأ به
ابدأ بـ
generateContent الأصلي لـ Gemini عندما تكون تبني سير عمل Gemini جديدًا. استخدم المسار المتوافق مع OpenAI عندما يكون تطبيق موجود يعتمد بالفعل على OpenAI SDK أو بُنى طلبات Chat Completions.حقول Gemini الأصلية تفشل مع Chat Completions
حقول Gemini الأصلية تفشل مع Chat Completions
أرسل طلبات
contents وparts وgenerationConfig وstreamGenerateContent إلى endpoint الأصلي لـ Gemini. يتوقع المسار المتوافق مع OpenAI وجود messages ومعاملات Chat Completions.model ID الخاص بـ Gemini يفشل
model ID الخاص بـ Gemini يفشل
تأكد من أن model ID متاح لحسابك ويدعم المسار الذي تستدعيه. استخدم صفحة النماذج للعثور على model IDs الحالية.
يشير SDK إلى الخدمة الخاطئة
يشير SDK إلى الخدمة الخاطئة
بالنسبة إلى طلبات Google GenAI SDK، اضبط عنوان URL الأساسي على
https://api.cometapi.com. وبالنسبة إلى طلبات OpenAI SDK، اضبط base_url في Python أو baseURL في Node.js على https://api.cometapi.com/v1.الخطوات التالية
- استخدم مرجع Gemini native API للاطلاع على حقول الطلب والاستجابة الكاملة لـ
generateContent. - اقرأ مرجع Chat Completions API للتعرّف على بنية الطلب المتوافقة مع OpenAI.
- اضبط عملاء OpenAI SDK في استخدام CometAPI مع OpenAI SDKs.
- اعرض النماذج المتاحة باستخدام عرض نماذج CometAPI المتاحة.
- أضف معالجة إعادة المحاولة وحدود المعدل باستخدام أكواد الأخطاء واستراتيجية إعادة المحاولة.