跳到主要内容

故障排查

本页中的 {baseUrl} 是平台 API 根地址（不含末尾 / 或 /v1），使用前请替换为实际地址。模型、价格和界面以当前控制台及客户端版本为准。

错误码对照表​

HTTP 状态码error.code含义与处理
400INVALID_REQUEST请求参数有误，例如 model 或 prompt 缺失、model 格式不正确。核对模型名拼写
401—Authorization 头缺失或 Token 无效。检查密钥是否完整、是否带了 Bearer 前缀
404TASK_NOT_FOUNDtask_id 不存在，或该任务不属于当前 API Key
429—触发速率限制或余额不足。降低并发，或检查余额
500INTERNAL_ERROR服务器内部错误，稍后重试
503—上游渠道不可用。换分组或换模型重试

错误响应统一格式：

{ "error": { "code": "...", "message": "..." } }

高频问题​

Q1：返回 401 token.not_provided

密钥没有正确传入。检查：

  • 是否带了 Bearer 前缀（注意后面有一个空格）
  • 客户端是否把密钥填到了正确的字段（有些客户端有"API Key"和"组织 ID"两个框）
  • 密钥是否已被删除或过期

Q2：返回 401 但密钥明明是对的

两种令牌搞混了。调用模型用 sk- 开头的模型密钥；调用 /api/... 管理接口用访问令牌。两者不通用。

Q3：返回 404 Invalid URL

地址拼接错了。最常见的是 /v1/v1/chat/completions。回顾地址书写规则：客户端自动补 /v1 时只填域名。

Q4：返回 model not found 或 该分组下无可用渠道

模型名拼写错误，或令牌的分组不包含该模型。解决：

  1. 用 GET /v1/models 确认模型名
  2. 在 控制台令牌页检查分组，或把分组改为「自动分组」

Q5：Claude Code 提示登录 / 要求订阅

环境变量没生效，或 ANTHROPIC_BASE_URL 写成了带 /v1 的形式。检查：

echo $ANTHROPIC_BASE_URL

应为 {baseUrl}。另外确认 ANTHROPIC_AUTH_TOKEN 已设置（不是 ANTHROPIC_API_KEY）。

Q6：Codex CLI 报 wire_api 相关错误

检查当前 Codex 版本的配置格式，并确认 wire_api = "responses"、base_url = "{baseUrl}/v1"。所用模型和上游需支持 /v1/responses；不要假设当前版本仍支持旧的 chat 模式。

Q7：客户端能连通但模型列表是空的

该客户端的"模型列表"是本地维护的，需要手动添加模型 ID，或点击"同步模型 / 检查"按钮从 /v1/models 拉取。

Q8：响应很慢或频繁超时

当前分组的上游线路拥塞。换一个分组（如从 cn1 换到 ovip2），或在客户端调小 max_tokens。

Q9：流式输出中断

部分客户端对 SSE 的处理有差异。尝试关闭客户端的"代理"设置，或改用非流式请求验证是否为客户端问题。

Q10：图片/视频任务提交后查不到结果

返回 task_id 的视频或图像生成接口属于异步任务，需要轮询查询端点；同步图像接口则直接返回结果。404 TASK_NOT_FOUND 说明 task_id 不属于当前 API Key——确认查询时用的是同一个密钥。