Skip to content

计费、额度与限速 ​

ThetaIO 按 Token 计费,金额单位为美元(USD)。一次请求能否通过,取决于账户余额或订阅额度,以及 Key 自身的额度和时间窗限额。

计费方式 ​

每次请求按以下 Token 分别计价,再乘以分组倍率:

Token 类型说明
输入提示词、系统提示、工具定义、历史消息
输出模型生成的内容,包括推理内容
缓存写入首次写入提示缓存的部分
缓存读取命中提示缓存的部分,单价通常低于输入

用量记录中有两个金额字段:

  • cost:按模型标准价计算的金额。
  • actual_cost:乘以分组倍率后的实际扣费金额。

各模型单价与分组倍率在控制台 模型广场 公布,文档副本见可用模型与价格。

两种付费模式 ​

模式扣费来源适用分组
钱包余额账户余额,按实际费用扣减按量分组
订阅订阅套餐的日 / 周 / 月额度订阅分组

余额不足时请求返回 403 INSUFFICIENT_BALANCE;订阅分组没有有效订阅时返回 403 SUBSCRIPTION_NOT_FOUND。

Key 级额度与限速 ​

创建 Key 时可以给它设置独立的上限,用来控制单个应用或成员的花费:

限制说明
总额度Key 累计可用的金额(USD),用完后 Key 进入额度耗尽状态
5 小时窗口任意 5 小时窗口内的金额上限
1 天窗口1 天窗口内的金额上限
7 天窗口7 天窗口内的金额上限
过期时间到期后返回 403 API_KEY_EXPIRED

窗口从该窗口内的第一次请求开始计时,到期后重置。剩余额度与重置时间可以用 GET /v1/usage 查询:

json
{
  "mode": "quota_limited",
  "quota": { "limit": 50, "used": 12.4, "remaining": 37.6, "unit": "USD" },
  "rate_limits": [
    { "window": "5h", "limit": 5, "used": 1.2, "remaining": 3.8, "reset_at": "2026-11-19T09:00:00+08:00" }
  ]
}

并发 ​

网关对用户和上游账号分别有并发上限。超出时请求可能被拒绝,客户端应对 429 和 5xx 做指数退避重试,参见错误。

不计费的请求 ​

  • POST /v1/messages/count_tokens:只校验余额,不记录用量。
  • GET /v1/models、GET /v1/usage。
  • 上游失败、未返回内容的请求。异步任务只在成功完成后计费。