إرسال طلبات الدردشة باستخدام OAuth

اختر هذا المسار عندما يقوم العميل بتفويض تطبيقك لاستخدام حساب ShareAI الذي اختاره. أكمل أولاً رمز التفويض باستخدام PKCE واحصل على منحة تتضمن surcharge.

curl --fail-with-body https://api.shareai.now/api/v1/chat/completions \
  -H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"model":"MODEL_IDENTIFIER","messages":[{"role":"user","content":"Hello!"}],"stream":false}'

يتم وضع رمز الوصول في ترويسة Bearer#

نقطة النهاية للدردشة وجسم الطلب هما نفس تدفق مفتاح API. الفرق هو بيانات الاعتماد ودورة حياة التفويض. يتم إرسال رمز التحديث فقط إلى نقطة نهاية الرمز؛ يتم استخدام رمز التعريف فقط لتسجيل الدخول إلى التطبيق الذي تم التحقق منه.

من يدفع وأي خطة تنطبق؟#

تحدد المنحة المقبولة الحساب الشخصي أو حساب المنظمة المختار، التطبيق وخطة الاستخدام. تحدد الخدمة هذه القيم من التفويض. لا ترسل معرف الدافع، رسوم Builder أو موضوع عميل آخر في جسم الدردشة لتغيير الفوترة.

تجديد الوصول دون فقدان الموافقة#

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

معالجة الفشل#

هوية النموذج ومزودي التنفيذ#

انسخ معرف النموذج المستند إلى المنشئ بالضبط من النماذج. اختر البنية التحتية بشكل منفصل باستخدام provider الكائن الاختياري. الترتيب الافتراضي يصنف المزودين المؤهلين حسب السعر، الأدنى أولاً. اختر المزودين أو استشر المرجع الكامل للسياسة.

حدود الإنفاق الشهرية واسترداد الفواتير#

يمكن لكل حساب دفع تحديد حد الإنفاق الشهري الخاص به على الذكاء الاصطناعي لكل تطبيق أو خدمة عميل في الفوترة → الاشتراكات والالتزامات. يشمل الحد تكلفة الشبكة ورسوم المطور، بينما تبقى الاشتراكات الثابتة والمشتريات المؤكدة منفصلة. خطأ الحد يستخدم HTTP 402 application_spending_limit_exceeded; استخدام أرصدة غير كافية مؤهلة يستخدم HTTP 402 insufficient_credits. كلاهما يوفر رابط فواتير العميل. مثال على عقد الخطأ، معالجة البث والتكامل.