Credit 計費

說明 API credit 的扣點規則、餘額回傳、餘額不足處理與用量對帳方式。

BCS API 採 credit 點數制計費。每把 API key 都有獨立的 credit 額度；系統會依 API endpoint、查詢成本與方案設定計算扣點。

Credit 用於控管 API 用量與成本，不代表實際法幣價格。實際方案、單價與加值方式依合約或報價單為準。

核心原則

核心原則

只有成功且需計費的 HTTP 2xx 回應才會扣除 credit。任何錯誤回應，包括 4xx 與 5xx，皆不扣點。

• 不同 endpoint 依查詢成本設定不同扣點權重。例如基礎資料查詢成本較低，資金流追蹤、風險分析或市場行為分析成本較高。

• 管理後台、健康檢查與部分沙盒試用端點不扣點。

• 每次成功回應會在 response.meta 與部分 response header 中回傳本次扣點與剩餘額度。

如何得知本次花費

成功回應會回傳本次扣點與剩餘額度。建議以 response.meta 作為系統對帳依據，response header 可作為即時監控與除錯輔助。

來源	欄位	意義
meta	credit_cost	本次請求扣除的 credit
meta	credit_remaining	扣點後的剩餘 credit
Header	X-Credit-Cost	本次請求扣除的 credit，對應 meta.credit_cost
Header	X-Credit-Remaining	扣點後的剩餘 credit，對應 meta.credit_remaining

{
  "data": { "...": "..." },
  "meta": { "credit_cost": 5, "credit_remaining": 9995 }
}

餘額不足

當剩餘 credit 不足以支付本次請求時，系統會回傳 402 insufficient_credit。該請求不會被處理，也不會扣點。

{
  "error": {
    "code": "insufficient_credit",
    "message": "insufficient credit: required 5, remaining 2"
  }
}

請聯絡管理員增加 credit、調整方案或切換至具足夠額度的 API key 後，再重新送出請求。

對帳

每筆扣點紀錄都會寫入不可覆寫的用量帳本，並記錄 request_id、API key、endpoint、扣點數、扣點後餘額與請求時間。客戶可依 request_id 對應 API 回應、客服紀錄與內部交易流水，進行事後對帳與稽核。

建議：客戶系統可在每次成功回應後讀取 meta.remaining_credits 或 X-Credit-Remaining，並在額度低於內部門檻時觸發提醒，避免正式服務中斷。

下一步

分頁