AnLinkAI

排障

当前 Beta 集成路径的错误处理。

当请求失败时，用本页快速定位原因。优先检查请求路径、API Key 状态、模型状态和账号余额，再判断是否存在更深层的平台问题。

错误

常见失败类型

Beta 暴露的能力边界较窄，因此多数失败仍集中在少数原因上。请同时确认模型目录中的可用性，以及 Billing and Recharge 中的余额步骤。

401 Unauthorized

请求缺少有效 bearer token，或 API Key 无效。

  • 检查 Authorization header 格式
  • 确认 key 是否完整复制
  • 确认 key 尚未被吊销

403 Forbidden

凭证有效，但无权执行当前操作。

  • 检查路由是否仅限管理员
  • 检查控制台中的当前账号角色
  • 使用预期账号重试

404 Not Found

请求路径错误，或当前路由未暴露该模型 ID。

  • 确认调用的是 /chat/completions
  • 确认 base URL 正确
  • 确认模型 ID 与模型目录完全一致

429 / Balance rejection

额度或限制不允许请求继续执行。

  • 检查控制台剩余额度
  • 缩小请求规模用于验证
  • 检查试用额度是否已用完

Model disabled

模型存在于目录中，但当前并非 active。

  • 打开模型目录
  • 确认 status 字段为 active
  • 切换到其他 active 模型测试

Upstream request failure

请求已到达平台，但在上游执行或路由阶段失败。

  • 记录 request ID
  • 检查控制台 Usage Logs
  • 用更小 prompt 和更简单 payload 重试

Invalid request body

JSON 结构或必填字段格式错误。

  • 确认包含 model
  • 确认 messages 是 JSON 数组
  • 确认 Content-Type 为 application/json

快速路径

最小排障顺序

  1. 先检查请求路径和 base URL。
  2. 检查 API Key 是否仍然 active。
  3. 检查所选模型在模型目录中是否标记为 active。
  4. 检查控制台中的剩余额度。
  5. 在 Usage Logs 中查找对应请求记录。

Console URL

https://console.anlinkai.com

主要路径

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

下一页

/zh-CN/faq

模型目录

/zh-CN/model-catalog

账单

/zh-CN/billing-and-recharge