Usage & Billing
余额、用量与扣费
账户余额决定账户还能支付多少调用费用，API Key 额度和时间窗口限制这把 Key 最多能用多少。每次调用的实际用量与费用，应以控制台使用记录为准。
账户余额账户可用于结算的资金
Key 额度单把 Key 的消费上限
核账依据/usage 中的实际调用记录
账户余额和 Key 额度有什么区别
| 项目 | 作用 | 耗尽后的影响 | 是否增加可用资金 |
|---|---|---|---|
| 账户余额 | 支付账户下符合条件的 API 调用费用 | 需要按当前页面提示充值或兑换后才能继续结算 | 是，充值或兑换会改变账户可用余额 |
| Key 总额度 | 限制这把 Key 可累计消费的金额 | 该 Key 停止继续调用，其他 Key 仍受账户余额和各自限制约束 | 否，只是消费上限 |
| Key 时间窗口限额 | 限制一段时间内的消费，例如按小时或按日 | 等待窗口重置，或按实际需要调整限制 | 否，只是速率或消费边界 |
| Key 有效期与状态 | 控制 Key 在什么时间、是否允许使用 | 到期、停用或删除后不能继续鉴权 | 否 |
提高 Key 额度不会给账户充值。即使 Key 仍有额度，账户余额不足、Key 过期、分组不匹配或其他限制也可能使请求失败。
常见计费项怎么理解
| 计费项 | 通常表示 | 核对位置 |
|---|---|---|
| 输入 | 请求发给模型的文本、上下文或其他计量输入 | 单次使用记录中的输入用量与费用字段 |
| 输出 | 模型生成的文本、推理内容或其他计量输出 | 单次使用记录中的输出用量与费用字段 |
| 缓存创建或写入 | 将符合条件的上下文写入缓存所记录的用量 | 缓存创建、缓存写入及对应费用字段 |
| 缓存读取 | 后续请求命中可复用缓存所记录的用量 | 缓存读取及对应费用字段 |
| 图片、视频或其他媒体 | 可能按 Token、张数、次数、时长、尺寸或模型规则结算 | 该次记录的计费模式、数量、用量和实际费用 |
| 按次请求 | 不以文本 Token 为主要计量单位的能力 | 该次记录的计费模式和实际费用 |
不同模型和能力不一定包含全部字段，字段为零也不代表所有能力免费。当前模型、计费模式和公开价格请查看模型广场与计费说明，历史调用不要用当前价格简单倒推。
如何核对一次调用
- 记录请求时间。保存日期、精确时间和时区，并记录客户端、端点和模型。
- 保留可追踪信息。保存 HTTP 状态码、错误类型和响应中的请求 ID；不要记录完整 Key。
- 打开使用记录。登录同一账户并进入
/usage，按时间、Key、模型或端点定位调用。 - 核对计费模式。先确认是按 Token、按次、按图片、按视频还是其他模式，再核对相应数量。
- 核对实际费用。以该条记录展示的用户实际费用为准，不用供应商参考价或当前价格替代。
失败请求是否扣费
不能只凭 HTTP 状态或客户端显示的“失败”判断是否产生费用。请求可能在鉴权、参数校验阶段就被拒绝，也可能在模型已经处理后因网络中断、流式连接中断或客户端解析失败而表现为失败。
- 先等待使用记录刷新，再按请求时间和请求 ID 查找对应记录。
- 找到记录时，以其中的计费模式、用量和实际费用为准。
- 没有找到对应使用记录时，不要用余额的粗略变化推断单次费用；同一时段的其他并发调用也会改变余额。
- 记录与客户端证据矛盾时，整理脱敏证据联系支持核对，不要为了复现而高频重复请求。
公开 API Key 用量查询页的边界
API Key 用量查询页无需登录账户，但需要提交完整 API Key 才能查询。它用于 Key 持有者在本站域名核对 Key 状态、额度或余额信息以及聚合用量，不代表这些数据可以被搜索引擎或任意访客直接检索。
| 适合使用 | 不适合使用 |
|---|---|
| 无法登录控制台但需要核对自己持有的 Key | 将 Key 提交给第三方“用量查询”网站、机器人或浏览器扩展 |
| 查询单把 Key 的状态、限制和聚合用量 | 替代账户级的完整使用记录、错误记录或订单记录 |
| 在地址栏确认域名为本站后手动输入 | 把带有 Key 的截图、录屏、链接或表单内容发给他人 |
完整 API Key 是可调用服务的敏感凭据。不要将它提交给不可信网站、机器人、浏览器扩展、远程代配人员或支持渠道。若自愿使用 Key 页面的 CC Switch 可选导入，二次确认后完整 Key 会交给本机第三方应用，本站不能保证其存储和后续行为；请使用独立、低额度且可随时停用的 Key。能登录时优先使用账户使用记录，它无需再次输入完整 Key。
对扣费有异议时准备什么
从官方支持页进入当前支持渠道，并提供能唯一定位问题但不泄露凭据的证据：
- 请求日期、精确时间、时区和大致持续时间；
- Key 名称或仅保留少量末尾字符的脱敏标识；
- 模型标识、请求端点、HTTP 方法和是否流式；
- HTTP 状态码、错误类型、脱敏后的错误正文和请求 ID；
/usage对应记录中的用量、计费模式和实际费用；- 客户端名称、版本、操作系统及是否使用代理。
不要提交完整 API Key、密码、验证码、付款二维码、未经遮挡的订单或账户截图、私密提示词、输入文件及完整响应正文。若截图不可避免，应先遮挡与核账无关的信息。
降低意外消费风险
- 不同项目、环境和成员使用独立 Key，并设置能承受的总额度和时间窗口限额。
- 开发和测试 Key 使用较短有效期，生产 Key 采用最小可用范围。
- 客户端重试必须设置次数上限和退避，参数或权限错误修正后再重试。
- 定期查看使用记录；发现未知调用时立即停用 Key、创建新 Key 并更新服务配置。
- 调用媒体或长上下文能力前，先在模型广场确认当前计费模式和价格。