> For the complete documentation index, see [llms.txt](https://docs.blockchainsecurity.asia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockchainsecurity.asia/help-center/fang-an-yu-ji-fei/how-credit-billing-works.md).

# 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](/help-center/guan-li/managing-api-keys.md)。

## 如何調整方案

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

{% hint style="info" %}
每筆扣點都會寫入帳本並關聯 `request_id`，可供事後對帳。需要用量明細請洽客戶經理。
{% endhint %}