बिलिंग त्रुटी आणि ग्राहक खर्च मर्यादा हाताळा

ओळखीसाठी ShareAI सह लॉग-इन वापरा आणि खात्याद्वारे निधी असलेल्या क्रियांसाठी स्पष्ट Pay with ShareAI अधिकृतता वापरा. openid केवळ व्याप्ती खर्च अधिकृत करत नाही. AI इनफरन्ससाठी inference किंवा मंजूर, सहमती दिलेली surcharge अनुदान आवश्यक आहे; payments विनंत्या स्वतंत्रपणे पुष्टी केलेल्या चेकआउट्ससाठी. ग्राहक Console मध्ये मासिक AI मर्यादा नियंत्रित करतो. तुमचे अनुप्रयोग ते बदलू शकत नाहीत.

कोडद्वारे त्रुटी हाताळा#

HTTP 402 · insufficient_credits: देय खात्याकडे या प्रदाता/मॉडेल आणि विनंतीसाठी पात्र असलेल्या पुरेशा न संपलेल्या क्रेडिट्सची कमतरता आहे. ग्राहकाला त्यांचे क्रेडिट्स व्यवस्थापित करण्यास सांगा. काही क्रेडिट्सना प्रदाता किंवा मॉडेल मर्यादा असतात.

HTTP 402 · application_spending_limit_exceeded: मासिक मर्यादा गाठली आहे, राखीव विनंत्या उपलब्ध भत्ता वापरतात, किंवा या विनंतीचा शुल्क त्यास ओलांडेल. याला दर मर्यादा म्हणून किंवा स्वयंचलितपणे पुन्हा प्रयत्न करू नका. ग्राहकाला मर्यादा बदलण्यास सांगा किंवा reset_at.

HTTP 429 · oauth_rate_limit: तात्पुरती विनंती/एकत्रित मर्यादा. अनुसरण करा Retry-After आणि मर्यादित बॅकऑफ. HTTP 401 · consent_required: सहमती कालबाह्य, रद्द किंवा वैध नाही; नवीन अधिकृतता मिळवा टॉप-अप मागण्याऐवजी.

{
  "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 एक अचूक EUR दशांश स्ट्रिंग आहे आणि reset_at UTC आहे. ते मर्यादा त्रुटींवर उपस्थित असतात, आणि अपुरे क्रेडिट त्रुटींवर अनुपस्थित असू शकतात.

योग्य देय खाते उघडा#

एक दृश्यमान बिलिंग व्यवस्थापित करा क्रिया परत आलेल्या URL वापरून ऑफर करा. अपारदर्शक संदर्भ 15 मिनिटांनंतर कालबाह्य होतो, मूळ देय खाते आणि कनेक्शन ओळखतो, आणि साइन-इन पुनर्निर्देशन टिकवतो. Console साइन-इन केलेल्या अभ्यागताच्या मालक/प्रशासक परवानग्या तपासतो त्या खात्याची निवड करण्यापूर्वी. अनुप्रयोग मालकाच्या बिलिंग पृष्ठासह ते बदलू नका, अभिनेता ID तयार करू नका, प्रवेश टोकन जोडू नका, किंवा ग्राहकाला स्वयंचलितपणे पुनर्निर्देशित करू नका.

Console मूळसाठी allowlist वापरा आणि rel="noopener noreferrer" नवीन टॅब उघडताना. लिंक नेव्हिगेशन आहे, अधिकृतता नाही किंवा निधी जोडल्याचा पुरावा नाही. ते कायमस्वरूपी बुकमार्क म्हणून किंवा सार्वजनिक लॉगमध्ये संग्रहित करू नका. कालबाह्य झाल्यावर, ग्राहक थेट बिलिंग उघडू शकतो. ग्राहकाने स्पष्टपणे पुन्हा प्रयत्न करण्यास सांगितल्यानंतर नवीन विनंती नवीन लिंक परत करू शकते.

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 प्रवेश/बाइंडिंगपूर्वी मर्यादा तपासतो आणि सेटलमेंटवर अणुस्तरावर वास्तविक नेटवर्क खर्च प्लस अधिभार तपासतो. एकत्रित विनंत्या समान मर्यादा सामायिक करतात. इनपुट अंदाज हेडरूम राखतात; आउटपुट लांबी पूर्वी माहित नसते. उर्वरित भत्ता ओलांडणारा अंतिम शुल्क वापर डेबिट किंवा बिल्डर अधिभार क्रेडिटशिवाय नाकारला जातो.

Chat Completions SSE साठी, event: error समान error.code आणि पुनर्प्राप्ती फील्डसह हाताळा. Responses SSE साठी, response.failed हाताळा आणि वाचा response.error. प्रवाह सुरू झाल्यावर त्याचा HTTP स्थिती आधीच 200 आहे; अपूर्ण सामग्री यशस्वी पूर्णत्व सूचित करत नाही. निकाल पूर्ण म्हणून चिन्हांकित करू नका, डाउनस्ट्रीम देय क्रिया करा किंवा टर्मिनल त्रुटीनंतर स्वयंचलितपणे पुन्हा सबमिट करू नका. नॉन-स्ट्रीमिंग Chat, Responses, Embeddings आणि Images बिलिंग त्रुटी HTTP 402 रूट म्हणून उघड करतात error लिफाफा.

व्याप्ती आणि रीसेट्स#

कॅलेंडर महिना UTC मध्ये चालतो. मर्यादा प्रत्येक देणगीदार खाते आणि अनुप्रयोगासाठी आहे, OAuth क्लायंट्स, ग्रांट्स आणि रीफ्रेश केलेल्या टोकन्समध्ये सामायिक केली जाते; क्लायंट सेवा उत्पादन की रोटेशनमध्ये त्याचा स्थिर कार्य ID वापरते. फक्त स्थिर AI नेटवर्क खर्च आणि अधिभार मोजला जातो. निश्चित सदस्यता आणि स्वतंत्रपणे पुष्टी केलेल्या खरेदींसाठी त्यांचे स्वतःचे चेकआउट अधिकृतता असते आणि त्या AI मर्यादा वापरत नाहीत. शून्य अतिरिक्त AI खर्च थांबवते; null म्हणजे कोणतीही मर्यादा नाही. मर्यादा संपादित केल्यावर किंवा कनेक्शन पुन्हा अधिकृत केल्यावर मागील शुल्क कायम ठेवले जाते.

हे ग्राहक नियंत्रण कन्सोलमध्ये आहेत, बजेट वाढवण्यासाठी डेव्हलपर एंडपॉइंट नाहीत. ग्रांटच्या स्कोप्स, मंजूर मॉडेल्स, ग्राहक प्रदाता प्राधान्ये आणि स्वीकारलेल्या अधिभार अटी लागू करत राहा. ग्राहक बिलिंग मार्गदर्शक · चेकआउट API.