ShareAI Platform Docs

التعامل مع أخطاء الفوترة وحدود إنفاق العملاء

تمييز الاعتمادات غير الكافية عن حد إنفاق التطبيق، تقديم رابط استرداد مدرك للفاعل والتعامل مع فشل البث بشكل صحيح.

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

استخدم Log-in with ShareAI للهوية والتفويض الصريح Pay with ShareAI للإجراءات الممولة من الحساب. openid النطاق وحده لا يصرح بالإنفاق. يتطلب AI inference inference أو منحة موافق عليها وموافقة عليها monetization_gateway منحة؛ payments الطلبات تتطلب عمليات دفع منفصلة مؤكدة. يتحكم العميل في حد شهري للذكاء الاصطناعي في وحدة التحكم. لا يمكن لتطبيقك تغييره.

التعامل مع الأخطاء حسب الكود#

HTTP 402 · insufficient_credits: الحساب الدافع يفتقر إلى أرصدة غير منتهية الصلاحية كافية ومؤهلة لهذا المزود/النموذج والطلب. اطلب من العميل إدارة أرصدته. بعض الأرصدة لديها قيود على المزود أو النموذج.

HTTP 402 · application_spending_limit_exceeded: تم الوصول إلى الحد الشهري، الطلبات المحجوزة تستخدم المخصص المتاح، أو أن رسوم هذا الطلب ستتجاوز ذلك. لا تعامل هذا كحد معدل أو حاول مرة أخرى تلقائيًا. اطلب من العميل تغيير الحد أو الانتظار حتى reset_at.

HTTP 429 · oauth_rate_limit: حد مؤقت للطلب/التزامن. اتبع Retry-After والتراجع المحدود. HTTP 401 · consent_required: انتهت صلاحية الموافقة أو تم إلغاؤها أو لم تعد صالحة؛ احصل على تفويض جديد بدلاً من طلب زيادة.

JSON

{
  "error": {
    "type": "billing_error",
    "code": "application_spending_limit_exceeded",
    "message": "This application's monthly AI spending limit has been reached or this request would exceed it. Manage the limit or wait for the next month.",
    "management_url": "https://console.shareai.now/?shareai_billing_context=OPAQUE_SHORT_LIVED_VALUE",
    "help": "https://console.shareai.now/?shareai_billing_context=OPAQUE_SHORT_LIVED_VALUE",
    "monthly_limit": "50",
    "reset_at": "2026-10-01T00:00:00Z"
  }
}

يستخدم الخطآن الماليان الاثنين error.type = billing_error. management_url هو وجهة استرداد العميل؛ help هو الاسم المستعار للتوافق الخاص به. monthly_limit هو سلسلة عشرية دقيقة باليورو و reset_at هو UTC. تظهر هذه القيم في أخطاء الحد الأقصى، ويمكن أن تكون غائبة في أخطاء عدم كفاية الرصيد.

افتح الحساب المدفوع الصحيح#

قدم عرضًا مرئيًا إدارة الفوترة إجراء باستخدام الرابط المُعاد. تنتهي صلاحية السياق الغامض بعد 15 دقيقة، ويحدد الحساب المدفوع الأصلي والاتصال، ويستمر بعد إعادة توجيه تسجيل الدخول. يتحقق الكونسول من أذونات المالك/المسؤول للزائر المسجل قبل اختيار ذلك الحساب. لا تستبدله بصفحة فوترة مالك التطبيق، أو تخترع معرف جهة فاعلة، أو تضيف رمز وصول، أو تعيد توجيه العميل تلقائيًا.

استخدم قائمة السماح لأصل الكونسول و rel="noopener noreferrer" إذا كنت تفتح علامة تبويب جديدة. الرابط هو للتنقل، وليس للتفويض أو إثبات أن الأموال قد أضيفت. لا تخزنه كإشارة مرجعية دائمة أو في سجلات عامة. عند انتهاء الصلاحية، يمكن للعميل فتح الفوترة مباشرة. يمكن أن تعيد طلب جديد رابطًا جديدًا بعد أن يطلب العميل صراحةً إعادة المحاولة.

JavaScript

const response = await fetch("https://api.shareai.now/api/v1/chat/completions", options);
const body = await response.json();
const error = body.error;
if (response.status === 402 && error?.type === "billing_error") {
  const message = error.code === "application_spending_limit_exceeded"
    ? "Your monthly limit for this app has been reached."
    : "Your ShareAI account needs eligible credits.";
  showBillingMessage(message);
  if (error.management_url) {
    const target = new URL(error.management_url);
    if (target.origin === "https://console.shareai.now") {
      // Render a user-activated link; never silently open it or retry spending.
      showManageBillingLink(target.href);
    }
  }
  return;
}
if (!response.ok || error) throw new Error(error?.message || "Request failed");
renderAnswer(body);

البث والتسوية النهائية#

ShareAI يتحقق من الحد الأقصى قبل القبول/الربط ويتحقق من التكلفة الفعلية للشبكة بالإضافة إلى surcharge بشكل ذري عند التسوية. تشترك الطلبات المتزامنة في نفس الحد الأقصى. تحفظ تقديرات الإدخال مساحة احتياطية؛ طول الإخراج غير معروف مسبقًا. يتم رفض الرسوم النهائية التي تتجاوز الحد المتبقي دون خصم استخدام أو رصيد منشئ surcharge.

بالنسبة لتكملات الدردشة SSE، تعامل event: error بنفس error.code وحقول الاسترداد. بالنسبة للاستجابات SSE، تعامل response.failed واقرأ response.error. بمجرد بدء البث، تكون حالة HTTP بالفعل 200; المحتوى الجزئي لا يعني الإكمال الناجح. لا تحدد النتيجة مكتملة، أو تنفذ إجراءات مدفوعة لاحقًا، أو تعيد الإرسال تلقائيًا بعد خطأ نهائي. تعرض الدردشة غير المتدفقة، والاستجابات، والتضمينات، والصور الخطأ الفوترة كجذر HTTP 402 error مغلف.

النطاق وإعادة التعيين#

الشهر الميلادي يعمل في UTC. الحد الأقصى لكل حساب مدفوع وتطبيق، مشترك عبر عملاء OAuth، والمنح والرموز المحدثة؛ يستخدم خدمة العميل معرف العمل المستقر الخاص بها عبر دورات تدوير المفتاح الإنتاجي. يتم احتساب تكلفة الشبكة AI المستقرة فقط بالإضافة إلى surcharge. الاشتراكات الثابتة والمشتريات المؤكدة بشكل منفصل لها تفويض خاص بها عند الخروج ولا تستهلك هذا الحد الأقصى للذكاء الاصطناعي. الصفر يوقف الإنفاق الإضافي للذكاء الاصطناعي؛ null يعني عدم وجود حد أقصى. يتم الاحتفاظ بالرسوم السابقة عند تعديل الحد أو إعادة تفويض الاتصال.

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

آخر تحديث نوفمبر 1, 2026

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

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

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

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

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI