常见错误

401 Unauthorized

通常表示 API Key 缺失、格式错误或已失效。

检查项：

• Authorization 请求头是否为 Bearer YOUR_AKAROUTER_API_KEY。
• Key 是否来自 AkaRouter 控制台。
• Key 是否被删除或轮换。

402 Payment Required

通常表示余额不足或账户计费状态不可用。

检查项：

• 钱包余额是否足够。
• 充值订单是否已经回调入账。
• 余额明细是否有异常扣费或冻结记录。

403 Forbidden

通常表示账号、模型或上游权限不允许当前请求。

检查项：

• 模型名是否来自控制台「模型状态」页面。
• 账号是否有权限使用该模型或通道。
• 是否正在使用错误的区域 Endpoint。

404 Not Found

通常表示路径错误。OpenAI 兼容请求应使用：

https://api.akarouter.com/v1/chat/completions

429 Too Many Requests

通常表示请求过快或上游限流。请降低并发，并使用指数退避重试。

5xx

500、502、503、504 代表服务端或上游临时异常。请保留请求时间、Endpoint、模型名和错误响应，再按工单流程反馈。