Skip to main content

ما الذي ستبنيه

سترسل طلب 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:
استخدم عنوان URL الأساسي المتوافق مع OpenAI فقط عندما يكون تطبيقك يستخدم بالفعل Chat Completions:

تنسيق 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.
أرسل طلبات contents وparts وgenerationConfig وstreamGenerateContent إلى endpoint الأصلي لـ Gemini. يتوقع المسار المتوافق مع OpenAI وجود messages ومعاملات Chat Completions.
تأكد من أن model ID متاح لحسابك ويدعم المسار الذي تستدعيه. استخدم صفحة النماذج للعثور على model IDs الحالية.
بالنسبة إلى طلبات Google GenAI SDK، اضبط عنوان URL الأساسي على https://api.cometapi.com. وبالنسبة إلى طلبات OpenAI SDK، اضبط base_url في Python أو baseURL في Node.js على https://api.cometapi.com/v1.

الخطوات التالية