常见问题排查
按账户、密钥、模型、客户端和网络的顺序定位问题。
按症状快速排查
| 症状 | 首先检查 |
|---|---|
| 提示未授权 | Bearer 鉴权、密钥状态、有效期和 IP 白名单 |
| 提示余额或额度不足 | 账户余额、密钥总额度和时间窗口限额 |
| 提示模型不可用 | 模型 ID、密钥分组和渠道状态 |
| 请求过多或被限流 | 并发、速率限制和短周期消费限额 |
| 连接超时 | 默认或亚太地址、渠道状态、代理和网络 |
推荐排查顺序
- 1
账户
确认余额、订阅或试用额度仍可用。
- 2
密钥
确认活跃、未过期、未触发额度/IP/速率限制。
- 3
模型
确认模型 ID 与密钥分组匹配。
- 4
渠道
检查渠道状态和近期可用率。
- 5
客户端
核对 Base URL、协议和 Bearer 鉴权。
- 6
网络
测速默认与亚太端点,检查代理和防火墙。
联系客服前准备
- 问题发生时间和时区
- 模型 ID 与密钥名称(不是完整密钥)
- 使用的客户端和系统
- 请求 ID 或日志截图(先遮盖 IP 与密钥)
- 默认与亚太地址的表现
- 渠道状态截图