配额、分组与访问限制
API Key 的剩余配额、过期时间、模型限制、IP 白名单和分组分别如何影响调用，触发限制时的报错，以及限流的处理方式。
以下限制都在控制台「API 密钥」页按密钥设置。
限制项一览
| 限制 | 作用 | 触发后的表现 |
|---|---|---|
| 剩余配额 | 限制该密钥的最大消费 | 额度用尽后无法继续调用（403 额度不足） |
| 过期时间 | 到期自动失效 | 返回 401 |
| 模型限制 | 只允许调用指定模型 | 调用其他模型返回 403；GET /v1/models 只返回允许的模型 |
| IP 白名单 | 只允许指定出口 IP | 其他 IP 调用返回 403 |
| 分组 | 选择渠道与计费策略，决定可用模型和分组倍率 | 分组内未启用的模型无法调用 |
账户余额不足同样会导致 403，见鉴权、余额与权限问题。
推荐设置
| 场景 | 建议 |
|---|---|
| 生产环境 | 独立密钥，设置配额上限，启用 IP 白名单 |
| 第三方工具或个人测试 | 独立密钥，设置配额上限和过期时间 |
| 只需要特定模型的应用 | 设置模型限制，避免误用高价模型 |
限流
请求过于频繁时返回 429。处理方式：降低并发，并使用指数退避重试，见限流、超时与流式中断。