Nglola kesalahan tagihan lan wates belanja pelanggan
Bedakake kredit sing ora cukup saka wates belanja aplikasi, tampilake pranala pemulihan sing sadar aktor lan ngatasi kegagalan streaming kanthi bener.
Ing kaca iki
Gunakake Log-in with ShareAI kanggo identitas lan otorisasi eksplisit Pay with ShareAI kanggo tumindak sing didanai akun. openid scope dhewe ora tau ngotorisasi pengeluaran. AI inference mbutuhake inference utawa hibah sing disetujoni lan disetujoni monetization_gateway hibah; payments panjaluk mbutuhake checkout sing dikonfirmasi kanthi kapisah. Pelanggan ngontrol watesan AI saben wulan ing Console. Aplikasi sampeyan ora bisa ngganti.
Tangani kesalahan kanthi kode#
HTTP 402 · insufficient_credits: akun pambayar ora duwe cukup kredit sing ora kadaluwarsa lan layak kanggo panyedhiya/model lan panjaluk iki. Jaluk pelanggan kanggo ngatur kredit. Sawetara kredit duwe watesan panyedhiya utawa model.
HTTP 402 · application_spending_limit_exceeded: watesan saben wulan wis tekan, panjaluk sing dipesen nggunakake alokasi sing kasedhiya, utawa biaya panjaluk iki bakal ngluwihi. Aja nganggep iki minangka watesan tarif utawa nyoba maneh kanthi otomatis. Jaluk pelanggan kanggo ngganti watesan utawa ngenteni nganti reset_at.
HTTP 429 · oauth_rate_limit: wates panjalukan/sambungan sementara. Tindakake Retry-After lan mundur kanthi watesan. HTTP 401 · consent_required: idin wis kadaluwarsa, dicabut utawa ora sah maneh; entuk otorisasi anyar tinimbang njaluk tambahan.
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"
}
}Kaloro kesalahan finansial nggunakake error.type = billing_error. management_url yaiku tujuan pemulihan pelanggan; help yaiku alias kompatibilitas. monthly_limit yaiku string desimal EUR persis lan reset_at yaiku UTC. Iki ana ing kesalahan cap, lan bisa ora ana ing kesalahan kredit sing ora cukup.
Bukak akun pembayaran sing bener#
Tawarkan sing katon Ngatur tagihan tumindak nggunakake URL sing bali. Konteks opaque kadaluwarsa sawise 15 menit, ngenali akun pembayaran asli lan sambungan, lan tetep sawise pangalihan mlebu. Console mriksa izin pemilik/admin pengunjung sing mlebu sadurunge milih akun kasebut. Aja ngganti karo kaca tagihan pemilik aplikasi, nggawe ID aktor, nambah token akses, utawa ngarahake pelanggan kanthi otomatis.
Gunakake daftar ijin kanggo asal Console lan rel="noopener noreferrer" yen mbukak tab anyar. Tautan kasebut minangka navigasi, dudu otorisasi utawa bukti yen dana wis ditambah. Aja nyimpen minangka tandha permanen utawa ing log umum. Nalika kadaluwarsa, pelanggan bisa mbukak Billing langsung. Panjalukan anyar bisa bali tautan anyar sawise pelanggan kanthi jelas njaluk nyoba maneh.
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);Streaming lan penyelesaian pungkasan#
ShareAI mriksa cap sadurunge mlebu/ikat lan mriksa biaya jaringan nyata plus surcharge kanthi atomik nalika penyelesaian. Panjalukan sing bebarengan nuduhake cap sing padha. Taksi input nyimpen ruang kepala; dawa output ora dingerteni sadurunge. Biaya pungkasan sing bakal ngluwihi tunjangan sing isih ana ditolak tanpa debit panggunaan utawa kredit builder surcharge.
Kanggo Chat Completions SSE, nangani event: error kanthi padha error.code lan lapangan pemulihan. Kanggo Responses SSE, nangani response.failed lan maca response.error. Sawise stream diwiwiti status HTTP wis 200; konten parsial ora ateges rampung kanthi sukses. Aja nandhani asil rampung, nindakake tumindak mbayar hilir utawa ngirim maneh kanthi otomatis sawise kesalahan terminal. Chat Non-streaming, Responses, Embeddings lan Images mbukak kesalahan tagihan minangka akar HTTP 402 error amplop.
Ruang lingkup lan reset#
Wulan kalender mlaku ing UTC. Cap kasebut saben akun pembayaran lan aplikasi, dienggo bareng ing klien OAuth, hibah lan token sing dianyari; layanan klien nggunakake ID kerja sing stabil ing rotasi kunci Produksi. Mung biaya jaringan AI sing wis diselesaikan plus surcharge sing diitung. Langganan tetep lan tuku sing dikonfirmasi kanthi kapisah duwe otorisasi checkout dhewe lan ora nggunakake cap AI iki. Nol ngaso belanja AI tambahan; null tegese ora ana cap. Biaya kepungkur tetep nalika watesan diowahi utawa sambungan diotorisasi maneh.
Iki minangka kontrol pelanggan ing Console, dudu titik pungkasan pangembang kanggo nambah anggaran. Terus ngetrapake ruang lingkup hibah, model sing disetujoni, preferensi panyedhiya pelanggan lan syarat surcharge sing ditampa. Pandhuan tagihan pelanggan · API Checkout.
Paling anyar dianyari Novèmber 1, 2026