计费、额度与限速
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。- 上游失败、未返回内容的请求。异步任务只在成功完成后计费。