বিলিং ত্রুটি এবং গ্রাহকের ব্যয় সীমা পরিচালনা করুন

পরিচয় নিশ্চিত করতে ShareAI-এ লগ-ইন এবং অ্যাকাউন্ট-ফান্ডেড কার্যক্রমের জন্য স্পষ্ট Pay with ShareAI অনুমোদন ব্যবহার করুন। openid শুধুমাত্র সুযোগ ব্যয় অনুমোদন করে না। AI ইনফারেন্সের জন্য inference বা অনুমোদিত, সম্মত surcharge অনুমোদন প্রয়োজন; payments অনুরোধগুলি আলাদাভাবে নিশ্চিত চেকআউটের মাধ্যমে সম্পন্ন হয়। কনসোলে গ্রাহক একটি মাসিক AI সীমা নিয়ন্ত্রণ করেন। আপনার অ্যাপ্লিকেশন এটি পরিবর্তন করতে পারবে না।

কোড দ্বারা ত্রুটি পরিচালনা করুন#

HTTP 402 · HTTP পেমেন্ট প্রয়োজন · insufficient_credits: পেমেন্ট অ্যাকাউন্টে এই প্রোভাইডার/মডেল এবং অনুরোধের জন্য উপযুক্ত পর্যাপ্ত অব্যবহৃত ক্রেডিট নেই। গ্রাহককে তাদের ক্রেডিট পরিচালনা করতে বলুন। কিছু ক্রেডিটের প্রোভাইডার বা মডেল সীমাবদ্ধতা থাকতে পারে।

HTTP 402 · HTTP পেমেন্ট প্রয়োজন · 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 ব্যবহার করে। অস্বচ্ছ প্রসঙ্গটি ১৫ মিনিট পরে মেয়াদোত্তীর্ণ হয়, মূল পেমেন্ট অ্যাকাউন্ট এবং সংযোগ সনাক্ত করে এবং সাইন-ইন রিডাইরেক্টের পরে টিকে থাকে। কনসোল সাইন-ইন করা দর্শকের মালিক/অ্যাডমিন অনুমতিগুলি যাচাই করে সেই অ্যাকাউন্টটি নির্বাচন করার আগে। এটি অ্যাপ্লিকেশন মালিকের বিলিং পৃষ্ঠা দিয়ে প্রতিস্থাপন করবেন না, একটি অ্যাক্টর আইডি উদ্ভাবন করবেন না, একটি অ্যাক্সেস টোকেন যোগ করবেন না, বা গ্রাহককে স্বয়ংক্রিয়ভাবে রিডাইরেক্ট করবেন না।

কনসোল উৎসের জন্য একটি অনুমোদিত তালিকা ব্যবহার করুন এবং 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 স্ট্যাটাস ইতিমধ্যেই ২০০; আংশিক বিষয়বস্তু সফল সমাপ্তি বোঝায় না। ফলাফল সম্পূর্ণ চিহ্নিত করবেন না, ডাউনস্ট্রিম পেইড অ্যাকশন সম্পাদন করবেন না বা একটি টার্মিনাল ত্রুটির পরে স্বয়ংক্রিয়ভাবে পুনরায় জমা দেবেন না। নন-স্ট্রিমিং চ্যাট, প্রতিক্রিয়া, এম্বেডিং এবং ইমেজগুলি একটি HTTP 402 রুট error এনভেলপ হিসাবে বিলিং ত্রুটি প্রকাশ করে।

সুযোগ এবং রিসেট#

ক্যালেন্ডার মাসটি UTC-তে চলে। সীমা প্রতি পেমেন্ট অ্যাকাউন্ট এবং অ্যাপ্লিকেশনের জন্য নির্ধারিত, যা OAuth ক্লায়েন্ট, গ্রান্ট এবং রিফ্রেশড টোকেনের মধ্যে ভাগ করা হয়; একটি ক্লায়েন্ট সার্ভিস তার স্থিতিশীল কাজের আইডি ব্যবহার করে প্রোডাকশন কী রোটেশনের সময়। শুধুমাত্র স্থির AI নেটওয়ার্ক খরচ এবং সারচার্জ গণনা করা হয়। নির্দিষ্ট সাবস্ক্রিপশন এবং আলাদাভাবে নিশ্চিতকৃত কেনাকাটা তাদের নিজস্ব চেকআউট অনুমোদন রয়েছে এবং এই AI সীমা ব্যবহার করে না। শূন্য অতিরিক্ত AI ব্যয় বন্ধ করে; null মানে কোনো সীমা নেই। সীমা সম্পাদনা বা সংযোগ পুনরায় অনুমোদিত হলে পূর্ববর্তী চার্জ সংরক্ষিত থাকে।

এগুলি কনসোলে গ্রাহক নিয়ন্ত্রণ, ডেভেলপার এন্ডপয়েন্ট নয় বাজেট বাড়ানোর জন্য। গ্রান্টের স্কোপ, অনুমোদিত মডেল, গ্রাহক প্রদানকারী পছন্দ এবং গৃহীত সারচার্জ শর্তাবলী কার্যকর করতে থাকুন। গ্রাহক বিলিং গাইড · চেকআউট API.