Nggarap kesalahan billing lan watesan belanja pelanggan

Gunakake Log-in karo ShareAI kanggo identitas lan otorisasi eksplisit Pay with ShareAI kanggo tumindak sing didanai akun. Cakupan openid dhewe ora tau ngotorisasi pengeluaran. Inferensi AI mbutuhake inference utawa hibah sing disetujui lan disetujui surcharge kanthi eksplisit; payments panjalukan checkout sing dikonfirmasi kanthi kapisah. Pelanggan ngontrol watesan AI saben wulan ing Console. Aplikasi sampeyan ora bisa ngganti.

Nggarap kesalahan miturut kode#

HTTP 402 · insufficient_credits: akun pambayaran ora nduweni cukup kredit sing durung kadaluwarsa sing layak kanggo panyedhiya/model lan panjalukan iki. Jaluk pelanggan kanggo ngatur kredit. Sawetara kredit duwe watesan panyedhiya utawa model.

HTTP 402 · application_spending_limit_exceeded: watesan saben wulan wis tekan, panjalukan sing dipesen nggunakake alokasi sing kasedhiya, utawa biaya panjalukan iki bakal ngluwihi. Aja nganggep iki minangka watesan tingkat utawa nyoba maneh kanthi otomatis. Jaluk pelanggan kanggo ngganti watesan utawa ngenteni nganti reset_at.

HTTP 429 · oauth_rate_limit: watesan panjalukan/konkurensi 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.

{
  "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"
  }
}

Loro kesalahan finansial nggunakake error.type = billing_error. management_url yaiku tujuan pemulihan pelanggan; help yaiku alias kompatibilitas. monthly_limit yaiku string desimal EUR sing pas lan reset_at yaiku UTC. Iki ana ing kesalahan watesan, lan bisa uga ora ana ing kesalahan kredit sing ora cukup.

Mbukak akun pambayaran sing bener#

Tawarkan Kelola pambayaran tumindak sing katon nggunakake URL sing bali. Konteks opaque kadaluwarsa sawise 15 menit, ngenali akun pambayaran asli lan sambungan, lan tetep sawise pangalihan mlebu. Console mriksa ijin pemilik/admin pengunjung sing mlebu sadurunge milih akun kasebut. Aja ngganti karo kaca pambayaran 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 ditambahake. Aja nyimpen minangka bookmark permanen utawa ing log umum. Yen kadaluwarsa, pelanggan bisa mbukak Billing langsung. Panjalukan anyar bisa bali tautan anyar sawise pelanggan kanthi eksplisit njaluk nyoba maneh.

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 watesan sadurunge mlebu/ikat lan mriksa biaya jaringan nyata ditambah surcharge kanthi atomik nalika penyelesaian. Panjalukan sing bebarengan nuduhake watesan sing padha. Perkiraan input nyimpen ruang kepala; dawa output ora dingerteni sadurunge. Biaya pungkasan sing bakal ngluwihi alokasi sing isih ana ditolak tanpa debit panggunaan utawa kredit surcharge builder.

Kanggo Chat Completions SSE, nggarap event: error kanthi error.code lan lapangan pemulihan sing padha. Kanggo Responses SSE, nggarap 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 nampilake kesalahan pambayaran minangka amplop root HTTP 402 error .

Cakupan lan reset#

Wulan kalender mlaku ing UTC. Watesan kasebut kanggo akun pambayaran lan aplikasi, dienggo bareng antarane klien OAuth, grant lan token sing di-refresh; 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 ngonsumsi watesan AI iki. Nol ngaso pengeluaran AI tambahan; null tegese ora ana watesan. Biaya sing kepungkur tetep disimpen nalika watesan diedit utawa sambungan diotorisasi maneh.

Iki kontrol pelanggan ing Console, dudu titik pungkasan pangembang kanggo nambah anggaran. Terusake ngleksanakake lingkup grant, model sing disetujoni, preferensi penyedia pelanggan lan syarat surcharge sing ditampa. Pandhuan tagihan pelanggan · API Checkout.