ShareAI Platform Docs

إنشاء إكمال دردشة

أرسل طلب إكمال محادثة ShareAI باستخدام مفتاح API Bearer وفهم النموذج المدعوم، الرسائل وحقول البث.

عرض كـ Markdown
في هذه الصفحة
POST https://api.shareai.now/api/v1/chat/completions

قم بتشغيل طلب محادثة باستخدام النموذج المحدد.

عنوان URL الأساسي
https://api.shareai.now
المصادقة
مفتاح API Bearer

هذا هو مسار التكامل الافتراضي للطلبات المدفوعة والمصرح بها بواسطة مساحة عمل مفتاح API الخاص بك. تنطبق قيود النموذج والمزود للمفتاح على التخصيص، بما في ذلك مسارات التراجع المسموح بها.

جسم الطلب#

الحقلالنوعالمعنى
modelسلسلة نصية، مطلوبمعرف النموذج المتاح بالضبط. انسخه من النماذج.
messagesمصفوفةرسائل المحادثة التي تحتوي على الدور والمحتوى.
streamمنطقيfalse يعيد نتيجة JSON واحدة؛ true يطلب أحداث مرسلة من الخادم.

استخدم محتوى الرسائل النصية. أرسل أدوارًا مثل system, user و assistant حسب الاقتضاء للمحادثة. قم بتضمين تاريخ المحادثة الذي تريد أن يستخدمه النموذج؛ لا تفترض أن الطلبات تشترك في محادثة مخزنة.

cURL

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/chat/completions" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "MODEL_IDENTIFIER",
  "messages": [
    {
      "role": "system",
      "content": "Be concise and helpful."
    },
    {
      "role": "user",
      "content": "Give me three ideas for a local community event."
    }
  ],
  "stream": false
}'

الاستجابة#

نتيجة مكتملة غير متدفقة تعيّن done إلى true وتعيد النص المُولد عند message.content. المستوى الأعلى يحمل أيضًا done_reason و consumption_type. يستخدم البث تنسيقًا مختلفًا، chat-completion-chunk. لا تفترض أن النتيجة غير المتدفقة تحتوي على مصفوفة خيارات بأسلوب OpenAI.

JSON

{
  "done": true,
  "done_reason": "stop",
  "consumption_type": "credits",
  "message": {
    "role": "assistant",
    "content": "Here are three ideas for your community event.",
    "done": true,
    "done_reason": "stop"
  }
}

هذه نتيجة مكتملة توضيحية؛ يصف consumption_type وضع التخصيص الفعلي. تحقق من وجود خطأ على المستوى الأعلى حتى عندما تكون حالة HTTP هي 200. النتيجة بدون جهاز تستخدم حاليًا error.code = no_device مع HTTP 200.

قيود النموذج والمزود#

قد يكون المفتاح محدودًا لنماذج ومزودين تنفيذ محددين. إذا تم رفض الوصول، تحقق من معلومات المفتاح وقم بتحديث المفتاح في وحدة التحكم فقط إذا كانت مساحة العمل المالكة تنوي منح هذا الوصول.

البث أو تفويض العميل#

بث استجابة · استخدم رمز وصول OAuth

آخر تحديث سبتمبر 15, 2026

مستندات منصة ShareAI
جميع المستندات

البحث حسب العنوان أو المحتوى.

اسأل عن هذه الصفحة

اختر مساعدًا لاستكشاف هذه الصفحة. يمكنك أيضًا نسخ الصفحة ولصقها في محادثتك.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI