Credit 計費怎麼運作

credit 如何扣點、如何查餘額、如何加值。

BCS API 採 credit（點數）制計費。

重點

• 每把 API key 有自己的 credit 餘額。

• 每個端點有各自的成本權重；呼叫時依權重扣點。

• 只有成功（HTTP 2xx）的回應才扣點——錯誤不扣。

• 管理／健康檢查類端點成本為 0。

怎麼知道花了多少

每個成功回應都會帶：

來源	欄位
Header X-Credit-Cost	本次扣除
Header X-Credit-Remaining	扣除後餘額
meta.credit_cost / meta.credit_remaining	信封內版本

餘額不足怎麼辦

餘額不足時，請求回 402 insufficient_credit，且不會扣點。請聯絡你方管理員加值。

如何加值

加值由管理員於管理後台操作（為指定 key 增加 credit）。詳見管理 API key。

如何調整方案

方案決定限流（RPS／Burst）與每月 credit 配額。需要調整方案時，請聯絡你的客戶經理，或由管理員建立新方案後將 key 套用過去。

每筆扣點都會寫入帳本並關聯 request_id，可供事後對帳。需要用量明細請洽客戶經理。