بلنگ کی غلطیوں اور صارف کے خرچ کی حدوں کو سنبھالیں

شناخت کے لیے 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 کے ماخذ کے لیے ایک اجازت فہرست استعمال کریں اور 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 داخلہ/بائنڈنگ سے پہلے حد کو چیک کرتا ہے اور تصفیہ پر ایٹمی طور پر اصل نیٹ ورک لاگت کے ساتھ اضافی چارج کو چیک کرتا ہے۔ ہم وقتی درخواستیں ایک ہی حد کو شیئر کرتی ہیں۔ ان پٹ تخمینے ہیڈ روم محفوظ رکھتے ہیں؛ آؤٹ پٹ کی لمبائی پہلے سے معلوم نہیں ہوتی۔ ایک حتمی چارج جو باقی الاؤنس سے تجاوز کرے گا اسے استعمال کے ڈیبٹ یا بلڈر اضافی چارج کریڈٹ کے بغیر مسترد کر دیا جاتا ہے۔

چیٹ کمپلیشنز SSE کے لیے، ہینڈل کریں event: error اسی کے ساتھ error.code اور بازیابی کے فیلڈز۔ جوابات SSE کے لیے، ہینڈل کریں response.failed اور پڑھیں response.error۔ ایک بار جب اسٹریم شروع ہو جائے تو اس کا HTTP اسٹیٹس پہلے ہی 200 ہے؛ جزوی مواد کامیاب تکمیل کا مطلب نہیں ہے۔ نتیجہ کو مکمل نہ نشان زد کریں، نیچے کی طرف ادا کی جانے والی کارروائیاں انجام نہ دیں یا کسی ٹرمینل غلطی کے بعد خودکار طور پر دوبارہ جمع نہ کریں۔ غیر اسٹریمنگ چیٹ، جوابات، ایمبیڈنگز اور امیجز بلنگ کی غلطی کو HTTP 402 روٹ کے طور پر ظاہر کرتے ہیں error لفافہ۔

دائرہ کار اور ری سیٹ#

کیلنڈر مہینہ UTC میں چلتا ہے۔ حد ہر ادائیگی کرنے والے اکاؤنٹ اور ایپلیکیشن کے لیے ہے، جو OAuth کلائنٹس، گرانٹس اور ریفریشڈ ٹوکنز کے درمیان مشترک ہے؛ ایک کلائنٹ سروس اپنی مستحکم ورک آئی ڈی پروڈکشن کی کی روٹیشنز کے دوران استعمال کرتی ہے۔ صرف طے شدہ AI نیٹ ورک لاگت اور اضافی چارج شمار ہوتے ہیں۔ فکسڈ سبسکرپشنز اور علیحدہ تصدیق شدہ خریداریوں کی اپنی چیک آؤٹ اجازت ہوتی ہے اور یہ اس AI حد کو استعمال نہیں کرتے۔ صفر اضافی AI خرچ کو روکتا ہے؛ null کا مطلب ہے کوئی حد نہیں۔ جب حد میں ترمیم کی جاتی ہے یا کنکشن کو دوبارہ مجاز بنایا جاتا ہے تو پچھلے چارجز برقرار رہتے ہیں۔

یہ کنسول میں کسٹمر کنٹرولز ہیں، بجٹ بڑھانے کے لیے ڈویلپر اینڈ پوائنٹ نہیں۔ گرانٹ کے اسکوپس، منظور شدہ ماڈلز، کسٹمر پرووائیڈر ترجیحات اور قبول شدہ اضافی چارج شرائط کو نافذ کرتے رہیں۔ کسٹمر بلنگ گائیڈ · چیک آؤٹ API.