處理賬單錯誤同客戶消費限額

使用 ShareAI 登入進行身份驗證，並用 ShareAI 授權付款進行帳戶資金操作。範圍本身唔會授權支出。AI 推理需要 openid 或經批准、同意嘅授權； inference 請求需單獨確認結帳。客戶喺 Console 裏面控制每月 AI 限額。你嘅應用程式唔可以更改呢個限額。 surcharge HTTP 402 ·; payments ：付款帳戶冇足夠未過期嘅信用額，唔符合呢個供應商/模型同請求嘅要求。請客戶管理佢哋嘅信用額。有啲信用額有供應商或者模型限制。

按代碼處理錯誤#

：每月限額已達到，預留請求使用可用嘅配額，或者呢個請求嘅收費會超過限額。唔好將呢個當作速率限制或者自動重試。請客戶更改限額或者等到 insufficient_creditsHTTP 429 ·.

：每月限額已達到，預留請求使用可用嘅配額，或者呢個請求嘅收費會超過限額。唔好將呢個當作速率限制或者自動重試。請客戶更改限額或者等到 application_spending_limit_exceeded：臨時請求/並發限制。遵循 reset_at.

同有限嘅退避策略。 oauth_rate_limitHTTP 401 · Retry-After ：授權已過期、被撤銷或者唔再有效；獲取新嘅授權，而唔係要求充值。 呢兩個財務錯誤使用 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 係 UTC。喺限額錯誤中會出現，但喺信用額不足錯誤中可能缺失。 monthly_limit 提供一個可見嘅 reset_at 管理帳單.

開啟正確嘅付款帳戶#

操作，使用返回嘅 URL。呢個不透明嘅上下文喺 15 分鐘後過期，識別原始付款帳戶同連接，並喺登入重定向後仍然有效。Console 會檢查登入訪客嘅擁有者/管理員權限，然後先揀選嗰個帳戶。唔好用應用程式擁有者嘅帳單頁面取代，創建一個行為者 ID，附加訪問令牌，或者自動重定向客戶。 如果開新標籤，請使用 Console 原點嘅允許列表同 。呢條鏈接係導航用途，唔係授權或者證明資金已添加。唔好將其存儲為永久書籤或者喺公共日誌中記錄。過期後，客戶可以直接打開帳單。一個新請求可以喺客戶明確要求重試後返回新鏈接。

ShareAI 喺接納/綁定之前檢查限額，並喺結算時原子性檢查實際網絡成本加附加費。並發請求共享相同嘅限額。輸入估算保留餘量；輸出長度喺提前唔知道。最終收費如果超過剩餘配額，會被拒絕，唔會扣除使用費或者支付建設者附加費。 rel="noopener noreferrer" 對於 Chat Completions SSE，處理.

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);

串流同最終結算#

同樣嘅.

同恢復字段。對於 Responses SSE，處理 event: error 並閱讀 error.code 。一旦流開始，其 HTTP 狀態已經係 200；部分內容唔代表成功完成。唔好將結果標記為完成，執行下游付費操作或者喺終端錯誤後自動重新提交。非串流嘅 Chat、Responses、Embeddings 同 Images 會將帳單錯誤暴露為 HTTP 402 根 response.failed 信封。 response.error. 一旦流開始，佢嘅HTTP狀態已經係200；部分內容唔代表成功完成。唔好標記結果完成，執行下游付費操作或者喺終端錯誤後自動重新提交。非流式嘅Chat、Responses、Embeddings同Images會以HTTP 402根嘅形式暴露計費錯誤。 error 信封。

範圍同重置#

日曆月份以UTC計算。上限係按每個付款賬戶同應用程式計算，OAuth客戶端、授權同刷新嘅token都會共享呢個上限；客戶端服務喺生產密鑰輪換期間會用穩定嘅工作ID。只有已結算嘅AI網絡成本加附加費會計算喺內。固定訂閱同分開確認嘅購買有自己嘅結帳授權，唔會消耗呢個AI上限。零代表暫停額外嘅AI支出；null代表無上限。當編輯限制或者重新授權連接時，過去嘅收費會被保留。

呢啲係Console入面嘅客戶控制，唔係用嚟提高預算嘅開發者端點。繼續執行授權範圍、已批准嘅模型、客戶供應商偏好同接受嘅附加費條款。 客戶收費指南 · 結帳API.