ShareAI Platform Docs

قم بإجراء أول طلب لواجهة برمجة التطبيقات

قم بإنشاء مفتاح API لـ ShareAI، اختر نموذجًا متاحًا وأرسل طلب دردشة من خادمك باستخدام مصادقة Bearer.

عرض كـ Markdown
في هذه الصفحة

ابدأ هنا عندما تقوم تطبيقك بإرسال طلبات باستخدام مفتاح API من مساحة العمل الخاصة بك في ShareAI. تحتاج إلى حساب ShareAI، مفتاح نشط والوصول إلى النموذج الذي تريد تشغيله.

1. إنشاء مفتاح API#

فتح وحدة تحكم ShareAI واختر مساحة العمل التي ستملك المفتاح والاستخدام. افتح مفاتيح API, ، اختر إنشاء مفتاح API، أعط المفتاح اسمًا يمكن التعرف عليه واحفظ السر في بيئة الخادم الخاص بك.

أنشئ بيانات اعتماد الاستدلال وأدرها من مفاتيح API.أنشئ بيانات اعتماد الاستدلال وأدرها من مفاتيح API.
أنشئ بيانات اعتماد الاستدلال وأدرها من مفاتيح API.

2. اختيار نموذج#

فتح النماذج ونسخ معرف النموذج الدقيق المعروض هناك. تحقق من التوفر الحالي وقيود النموذج/المزود على مفتاحك. معرف في دليل قديم لا يضمن أن السعة متاحة اليوم.

3. إرسال الطلب#

POST https://api.shareai.now/api/v1/chat/completions

قم بإنشاء استجابة باستخدام نموذج متاح.

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

استبدل MODEL_IDENTIFIER باستخدام المعرف الذي اخترته. قم بتعيين SHAREAI_API_KEY في بيئتك قبل تشغيل المثال.

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": "user",
      "content": "Explain what ShareAI does in one sentence."
    }
  ],
  "stream": false
}'

4. قراءة النتيجة#

لطلب ناجح غير متدفق، تحقق من أن done صحيح واقرأ رسالة المساعد من message.content. تحقق من حالة HTTP وأي كائن خطأ في الجسم قبل اعتباره إكمالًا ناجحًا. يمكن أن تصل نتيجة عدم وجود جهاز حاليًا ككائن خطأ مع HTTP 200.

إذا فشل الطلب#

الحالةالخطوة التالية
401تحقق من المفتاح، مساحة العمل ورأس Authorization.
402تحقق من الرصيد المتاح أو الرصيد القابل للتطبيق.
403تحقق من النماذج والمزودين المسموح بهم.
429انتظر Retry-After عند وجوده، ثم حاول مرة أخرى مع تأخير محدود.
503تحقق من السعة الحالية أو توفر الخدمة؛ احتفظ بحد إعادة المحاولة.

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

مرجع طلب واستجابة الدردشة يشرح الجسم المدعوم. إذا كان يجب على كل عميل أن يصرح حسابه الخاص، اتبع OAuth للتطبيق.

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

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

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

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

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

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI