تخطَّ إلى المحتوى الرئيسي

بوابة الذكاء الاصطناعي: إكمالات المحادثة

نقطة طرفية لإكمالات المحادثة متوافقة مع OpenAI، مدعومة بمجمع AI Pool متعدد المزودين من Mersal.

3 دقيقة قراءة

بوابة الذكاء الاصطناعي هي واجهة أمامية لـ AI Pool الداخلي في Mersal — موجّه ذكاء اصطناعي متعدد المزودين مع تبديل تلقائي عند الفشل. بدلاً من الربط مع مزود ذكاء اصطناعي واحد وتثبيته داخل تطبيقك، ترسل الطلبات إلى نقطة Mersal الطرفية المتوافقة مع OpenAI، ويقوم AI Pool بتوجيه الطلب إلى مزود سليم. إذا تعطل أحد المزودين أو تدهور أداؤه، يبدّل المجمع تلقائيًا إلى مزود آخر، فتحصل دائمًا على إكمال يعمل.

تتبع أشكال الطلب والاستجابة اتفاقية إكمالات محادثة OpenAI، لذا تعمل الأدوات المتوافقة مع OpenAI الموجودة لديك عمومًا بأقل قدر من التعديلات — يكفي توجيهها إلى الرابط الأساسي الخاص بـ Mersal واستخدام مفتاح AI Pool الخاص بك.

النقطة الطرفية

POSThttps://mersal.it/api/ai/v1/chat/completions

المصادقة

تستخدم هذه النقطة الطرفية آلية مصادقة مختلفة عن نقاط إرسال القنوات: رمز Bearer، وليس ترويسة Api-key.

Authorization: Bearer <ai-pool-key>

تُنشأ مفاتيح AI Pool خصيصًا للوصول إلى بوابة الذكاء الاصطناعي، وهي منفصلة عن مفتاح API الخاص بالقنوات. راجع المصادقة لمعرفة أين يمكنك إنشاء واحد.

معاملات الطلب

الاسمالنوعمطلوبالوصف
messagesarrayنعممصفوفة رسائل المحادثة، كل رسالة تحتوي على role (مثل user أو assistant أو system) و content.
temperaturenumberلادرجة العشوائية في الاستجابة (sampling temperature).
max_tokensnumberلاالحد الأقصى لعدد الرموز (tokens) المولّدة في الإكمال.

مثال على الطلب

curl -X POST https://mersal.it/api/ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_AI_POOL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      { "role": "user", "content": "Hello" }
    ],
    "temperature": 0.5,
    "max_tokens": 600
  }'

مثال على الاستجابة

{
  "id": "chatcmpl-xxxxxxx",
  "object": "chat.completion",
  "created": 1730000000,
  "model": "mersal-pool",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hi there!" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 12, "completion_tokens": 8, "total_tokens": 20 },
  "mersal_pool": { "provider": "...", "model": "...", "latency_ms": 420, "attempts": 1 }
}

يوضّح كائن mersal_pool أي مزود فعليًا خدم الطلب، ومدة استغراقه، وعدد المحاولات التي أجراها المجمع (مفيد عندما يفشل أول مزود يتم تجربته وينتقل الطلب إلى مزود آخر).

عرض النماذج المتاحة

GEThttps://mersal.it/api/ai/v1/models

تُرجع هذه النقطة النماذج المتاحة حاليًا عبر AI Pool، باستخدام نفس مصادقة Bearer.

الأخطاء

أكثر حالات الفشل شيوعًا هي رمز Bearer مفقود أو غير صالح، أو التقييد (throttling) عند تجاوز حدود الطلبات المهيأة لمفتاحك — راجع حدود المعدل. للاطلاع على الشكل العام للأخطاء، راجع الأخطاء ورموز الحالة.

هل ساعدتك هذه الصفحة؟
بوابة الذكاء الاصطناعي: إكمالات المحادثة · شروحات مرسال