额度管理

平台为您的账户设置一道信用额度，按月度结算周期约束账户当月累计用量金额。额度随用量持续核减，接近上限时预警通知，达到上限时暂停服务，进入新结算月或提额后恢复。本页说明额度的核减口径、预警与暂停机制，以及提额申请方式。

额度是怎么设计的

平台采用单层汇总信用额度：整个账户共用一道额度上限，约束账户下全部密钥的累计用量金额，而非为每把密钥单独设额。

额度 vs 余额。 信用额度是一道用于风控的上限，不是预付充值的余额——您无需预先充值，平台按实际用量出具结算单，额度仅在累计用量逼近或达到上限时触发预警与暂停。

额度如何核减

额度的已用部分与账单同源：每一次查询计入用量，按统一计价词元的计量口径折算为含税金额，累加进当月已用额度。

• 同源核减。 额度的「当月已用」= 用量明细逐条金额之和 = 当月结算单分项合计，三者取自同一份用量底座；计量口径详见 用量明细与计量说明。
• 含税口径。 额度核减按含税金额计，与结算单的含税合计一致。
• 全密钥归集。 账户下所有密钥的用量统一归集到这一道额度，不论该用量来自哪个部门或业务线的密钥。

通过控制平面接口查询账户的汇总信用额度与当前使用情况：

curl https://<平台入口地址>/api/v1/credit \
  -H "Authorization: Bearer <控制台会话凭证>"

{
  "limit": 0,
  "used": 0,
  "usage_rate": "0%",
  "status": "normal",
  "currency": "CNY",
  "contract_limit": 0
}

接口返回为账户的实时口径；具体额度数额以服务协议与控制台为准，本文档不固化数值。

预警通知

当账户当月使用率达到预警阈值时，额度状态转为预警（warning），并通过控制台提示与通知渠道告知，提醒您关注用量节奏、酌情安排提额或调整调用。

• 预警状态下服务不受影响，请求照常处理；预警是提前量，便于您在达额前主动应对。
• 控制台「额度管理」页以预警角标呈现当前使用率，使用率回落或额度提升后自动解除。
• 预警阈值为接近上限的高百分位水平，具体阈值以服务协议与控制台为准。

建议。 收到预警后，可结合 用量明细 查看近期用量构成（哪个密钥、哪类查询增长较快），判断是临时峰值还是稳态抬升，再决定是否提额。

达额暂停与恢复

当账户当月累计已用达到信用额度上限时，额度状态转为暂停（suspended），平台对账户实施达额暂停。由于平台采用单层汇总额度，达额暂停时账户下全部密钥一并暂停——不存在「某把密钥还有余量可继续调用」的情况。

当月已用 ≥ 信用额度上限
        │
        ▼
   账户达额暂停（全部密钥一并暂停）
        │
        ▼
   新查询返回 429（额度暂停或限速）

暂停期间，数据平面查询请求返回 429（额度暂停或限速），请求不被处理；控制平面的查询、账单、额度等管理功能照常可用，您仍可查看用量与额度、提交提额申请。

账户可经由以下任一路径恢复正常，恢复后额度状态回到 normal，全部密钥同步恢复，无需逐把操作：

应用侧建议。 请在调用侧对 429 做好处理：识别为额度暂停后暂缓重试并触发内部告警，避免无效重试造成请求堆积。429 与其他错误码的区分详见 快速接入指南 · 常见接入问题。

提额申请

如预计用量将持续高于当前额度，可向平台提交提额申请，调整账户的信用额度上限。通过控制平面接口或控制台「额度管理」页的提额入口提交，登记期望额度、事由与申请方式：

curl https://<平台入口地址>/api/v1/credit/raise-tickets \
  -H "Authorization: Bearer <控制台会话凭证>" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_amount": 0,
    "reason": "<提额事由，如业务量增长、新业务线接入>",
    "channel": "<申请方式，如书面 / 邮件 / 正式函>"
  }'

提交后返回受理回执（含申请编号 ticket_id 与状态 received）。申请进度通过列表接口查询：

curl "https://<平台入口地址>/api/v1/credit/raise-tickets?page=1&page_size=20" \
  -H "Authorization: Bearer <控制台会话凭证>"

返回申请逐条记录，含申请编号、申请额度、当前状态（received / processing / approved / rejected）与处理时间。

关于额度的最终口径。 信用额度上限及其调整需结合服务协议确定，提额以服务协议约定及平台审定为准；本文档仅说明申请方式，不代表提额额度的承诺。

额度变更记录

每一次额度上限的调整（提额生效）都会留下一条变更记录，便于您回溯额度的历史轨迹：

curl "https://<平台入口地址>/api/v1/credit/changes?page=1&page_size=20" \
  -H "Authorization: Bearer <控制台会话凭证>"

返回变更逐条记录，每条含变更生效时间 changed_at、变更前上限 previous_limit、变更后上限 new_limit 与对应的提额申请编号 ticket_id。

接口一览

控制平面接口经控制台会话认证；列表接口统一支持 page / page_size 分页参数。错误返回统一采用结构化错误体，包含错误码、可读说明与请求追踪标识。

相关页面

本页所述额度上限、预警阈值等均为机制说明；具体额度数额、阈值与提额额度以服务协议与控制台实时口径为准，不在文档中固化。