401 / API Key 无效
检查 Bearer 前缀、Key 是否属于当前项目、环境变量是否生效、是否复制了空格。
TackleKey
API 中转排查
API 中转报错先别急着换平台，按这个顺序查
很多 API 中转报错不是平台坏了，而是 base URL、API Key、模型名、余额、并发或重试策略出了问题。先用一个小请求把问题定位清楚。
常见原因
429 / 限流
降低并发，使用退避重试，检查是否多个工具共用同一个 Key。
模型不存在
从实时价格页复制模型名，确认 endpoint 类型和请求格式匹配。
Base URL 不对
OpenAI-compatible 请求先用 `https://api.tacklekey.com/v1`，不要混用其他 provider 地址。
排查顺序
| 步骤 | 检查什么 | 入口 |
|---|---|---|
| 第一步：跑 cURL | 先用最小 HTTP 请求排除 SDK 或客户端配置问题。 | Open |
| 第二步：看日志 | 按时间、Key、模型、状态码和错误信息定位。 | Open |
| 第三步：看余额和价格 | 确认请求是否计费、模型价格是否符合预期。 | Open |
| 第四步：再小流量重试 | 修正配置后先发一个短 prompt，不要直接跑批量。 | Open |
不要把真实 API Key 发到公开群、Issue、截图或前端代码里。怀疑泄露时应撤销旧 Key 并创建新 Key。
FAQ
API 中转 401 一定是平台问题吗？
不一定。常见原因是 Key 错、Header 格式错、项目不匹配、环境变量没生效或 base URL 写错。
429 怎么处理？
先降低并发和重试频率，使用退避重试，再检查同一个 Key 是否被多个任务共用。
模型不存在怎么办？
从实时价格页复制模型名，确认模型仍可见，并用一个小请求验证。
用一次 OpenAI-compatible 配置先跑通
创建账号，生成项目 API Key，把客户端 base URL 换成 TackleKey 入口。Key 请放在服务端，扩大用量前先核对实时价格和日志。