बिलिंग त्रुटियों और ग्राहक खर्च सीमा को संभालें

पहचान के लिए 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 साइन-इन विज़िटर के मालिक/प्रशासक अनुमतियों की जांच करता है इससे पहले कि वह उस खाते का चयन करे। इसे एप्लिकेशन मालिक के बिलिंग पृष्ठ से प्रतिस्थापित न करें, एक actor ID का आविष्कार न करें, एक एक्सेस टोकन संलग्न न करें, या ग्राहक को स्वचालित रूप से रीडायरेक्ट न करें।

Console मूल के लिए एक अनुमति सूची का उपयोग करें और 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 और रिकवरी फ़ील्ड्स के साथ संभालें। Responses SSE के लिए, error.code और पढ़ें response.failed । एक बार स्ट्रीम शुरू होने के बाद इसका HTTP स्टेटस पहले से ही 200 है; आंशिक सामग्री का मतलब सफल समापन नहीं है। परिणाम को पूर्ण न चिह्नित करें, डाउनस्ट्रीम भुगतान की गई क्रियाएं न करें या टर्मिनल त्रुटि के बाद स्वचालित रूप से पुनः सबमिट न करें। गैर-स्ट्रीमिंग Chat, Responses, Embeddings और Images बिलिंग त्रुटि को HTTP 402 रूट response.error. लिफाफे के रूप में उजागर करते हैं। error लिफाफा.

स्कोप और रीसेट्स#

कैलेंडर माह UTC में चलता है। सीमा प्रति भुगतान खाता और एप्लिकेशन के लिए है, जो OAuth क्लाइंट्स, ग्रांट्स और रिफ्रेश किए गए टोकन के बीच साझा की जाती है; एक क्लाइंट सेवा अपने स्थिर कार्य ID का उपयोग प्रोडक्शन की रोटेशन कुंजियों के दौरान करती है। केवल निपटाए गए AI नेटवर्क लागत और अधिभार की गणना होती है। फिक्स्ड सब्सक्रिप्शन और अलग से पुष्टि की गई खरीदारी का अपना चेकआउट प्राधिकरण होता है और यह इस AI सीमा का उपभोग नहीं करता। शून्य अतिरिक्त AI खर्च को रोकता है; null का मतलब है कोई सीमा नहीं। जब सीमा को संपादित किया जाता है या कनेक्शन को पुनः अधिकृत किया जाता है, तो पिछले शुल्क बनाए रहते हैं।

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