计费与限制

GLM 5 API 用量如何换算成积分：哪些积分可用于 API、费率与换算方式、预占与结算流程、余额不足和尚未付费时分别返回什么，以及频率限制与请求体大小限制。

API 调用与 Chat 共用同一个 GLM 5 积分余额，不存在需要单独充值的 API 钱包。账户完成首次成功付费后即可使用 Public API，按量积分包、月付订阅、年付订阅任意一种都算数；所有付费获得的积分和裂变奖励积分都可以用于 API，试用 / 注册赠送积分仅限网页端使用。

API 能用哪些积分

积分来源	Chat / 图像 / 视频	Public API
按量积分包	可以	可以
月付订阅积分	可以	可以
API 请求的退款积分	可以	可以
年付订阅积分	可以	可以
试用 / 注册赠送积分	可以	不可以
裂变奖励积分	可以	可以（已付费账户）

按量积分包、月付订阅、年付订阅、API 请求退款和裂变奖励都可以用于 API；裂变奖励积分需要账户已完成首次付费。试用 / 注册赠送积分不能用于 Public API。

/settings/apikeys 页面会同时展示两个数字：总积分 与 可用于 Public API；后者不包含试用 / 注册赠送积分。

API 积分费率

模型	输入	输出
`gpt-6-astra`	2,778 积分 / 100 万输入 Token	13,889 积分 / 100 万输出 Token
`claude-fable-5.1`	2,778 积分 / 100 万输入 Token	13,889 积分 / 100 万输出 Token
`glm-5.3-flash`	5 积分 / 100 万输入 Token	14 积分 / 100 万输出 Token
`glm-5.3`	78 积分 / 100 万输入 Token	245 积分 / 100 万输出 Token
`glm-5.2`	78 积分 / 100 万输入 Token	245 积分 / 100 万输出 Token
`glm-5`	84 积分 / 100 万输入 Token	278 积分 / 100 万输出 Token
`kimi-k3`	834 积分 / 100 万输入 Token	4,167 积分 / 100 万输出 Token
`kimi-k2`	84 积分 / 100 万输入 Token	334 积分 / 100 万输出 Token
`deepseek-r1`	98 积分 / 100 万输入 Token	362 积分 / 100 万输出 Token
`deepseek-v4-pro`	126 积分 / 100 万输入 Token	251 积分 / 100 万输出 Token
`deepseek-v4-flash`	39 积分 / 100 万输入 Token	78 积分 / 100 万输出 Token

gpt-6-astra：当单次请求的输入达到 272,000 token 及以上时，整个请求按 5,556 积分 / 100 万输入 Token 与 20,834 积分 / 100 万输出 Token 计费。

表格展示每 100 万输入/输出 Token 对应的积分消耗。美元价格仅作为辅助参考。

100 积分 = $1.80 的 API 使用价值。 内部按照 $0.018 / credit 把 API 用量换算成积分，并向上取整；完成的请求最低计费 1 积分。

预占与最终结算

GLM 5 使用两阶段计费：

估算输入 Token，并按请求中的最大输出预占积分；如果没有设置最大输出，则计费预占使用内部 8,192 Token 估算值。
把请求发送给模型。
读取本次完成请求的最终输入/输出 Token 用量。
用真实用量重新计算应扣积分。
返还没有实际使用的预占积分。

如果请求在预占之后失败，对应预占会被退款。

计费估算不是模型输出上限

未设置 max_completion_tokens 时使用的 8,192 Token 只是内部计费预占估算，不会改变模型的默认输出行为。最终按本次请求的实际用量结算。

计算示例

以 glm-5.3-flash 为例，假设某次请求产生 50,000 输入 Token 和 1,000 输出 Token，并按当前内部 API 价值计算：

input   = 50,000 / 1,000,000 × $0.075 = $0.00375
output  =  1,000 / 1,000,000 × $0.25  = $0.00025
total   = $0.00400
credits = ceil($0.00400 / $0.018) = 1

实际扣费以本次请求最终记录的 Token 用量为准，完成换算后再向上取整。

需要付费与余额不足

在完成首次成功付费之前，API 返回 HTTP 402，错误码为 code: "payment_required"，并附上定价页链接。

账户已付费后，如果「可用于 Public API」的积分无法覆盖请求预占，会返回：

{
  "error": {
    "message": "Insufficient credits. This request needs about 23 credits, but your account balance is 16. Buy credits or a subscription at https://glm5.app/pricing.",
    "type": "insufficient_quota",
    "code": "insufficient_quota",
    "param": null,
    "required_credits": 23,
    "current_credits": 16,
    "api_eligible_credits": 16,
    "total_credits": 16,
    "api_ineligible_credits": 0,
    "missing_credits": 7,
    "recharge_url": "https://glm5.app/pricing"
  }
}

对于已付费账户，current_credits、api_eligible_credits 和 total_credits 都等于同一个有效余额，api_ineligible_credits 为 0。当余额里仍包含试用 / 注册赠送积分时，api_ineligible_credits 就是这部分只能在网页端使用的积分。

HTTP 状态码为 402。

频率限制

每个 API Key 默认限制为每分钟 60 个请求；单个 Key 也可以配置自定义限制。

超过限制时返回 HTTP 429，错误码为 rate_limit_exceeded。

推荐使用带随机抖动的指数退避。额度不足、认证失败和参数校验错误不应立即自动重试。

请求体限制

POST /chat/completions 的请求体最大为 4 MB。超过限制时返回 HTTP 413 request_too_large。