限流
Trinity 会在账户、API Key、模型与网关策略等维度限制速率、并发与配额。具体 RPM / 并发 / 日额度以控制台、套餐与商务协议为准，文档不承诺固定数字。
| 我想… | 去这里 |
|---|---|
| 错误码总表 | 错误码 |
| 余额不足 402 | 充值与账单 |
| 打开控制台 | 控制台 ↗ |
限额类型
| 类型 | 说明 |
|---|---|
| 请求速率 | 单位时间请求数，超出可能 429 |
| 并发 | 同时进行中的请求 / SSE 连接数 |
| 用量配额 | 与余额、套餐、价目、结算相关 |
| 模型权限 | 未开通返回权限 / 模型类错误（非纯限流） |
常见响应
| 状态码 | 含义 | 建议 |
|---|---|---|
429 | 过快，或上游透传限流 | 指数退避；有 Retry-After 则按其等待 |
402 | 余额或额度不足 | 充值 |
403 | 权限或模型不可用 | Key 与模型权限 |
5xx | 临时异常 | 有限次重试并记录 X-Request-Id |
INFO
429 可能来自 Trinity 网关，也可能来自上游供应商。排障请记录 X-Request-Id。
客户端建议
- 对 429 与临时 5xx 使用指数退避，并设最大重试次数。
- 记录
X-Request-Id。 - 流式请求设超时与并发上限。
- 不要在客户端硬编码限额数字。