请求失败时，接口返回非 200 的 HTTP 状态码和错误信息。排查时请记录响应中的 request id，便于在控制台「调用诊断」中定位或提交给客服。AI 模型 API#
错误响应遵循 OpenAI 格式（Anthropic、Gemini 协议的接口返回各自的标准错误格式）：{
"error": {
"code": "",
"message": "无效的令牌 (request id: 20261024045136443822397f1ThV5v7)",
"type": "server_error"
}
}
| HTTP 状态码 | 常见信息 | 原因与处理 |
|---|
| 400 | 参数错误、invalid_request_error | 请求体格式或参数不符合该模型要求。检查 JSON 格式、参数名与取值范围 |
| 401 | 无效的令牌 | Key 错误、已删除，或使用了其他站点的 Key。请在控制台确认 Key |
| 401 / 403 | 该令牌已过期、该令牌额度已用尽、该令牌状态不可用 | Key 过期、达到额度上限或已停用。在 模型 API key 调整 |
| 403 | 用户额度不足 | 账户余额不足，请 充值 |
| 403 | error code: 1010 | 请求缺少 User-Agent 被安全防护拦截。使用官方 SDK，或为请求设置 User-Agent |
| 404 | Invalid URL、404 page not found | 路径错误，多数是 Base URL 的 /v1 多了或少了，见 Base URL 与 SDK 配置 |
| 404 / 503 | 模型不存在或已下架、分组 xxx 下模型 xxx 无可用渠道 | 模型名拼写错误，或当前 Key 的分组不支持该模型。改用「稳定优先」或换用支持该模型的分组 |
| 429 | 当前分组上游负载已饱和，请稍后再试 | 请求过于频繁或资源繁忙。降低并发、指数退避重试 |
| 500 / 502 | upstream error、do request failed | 上游服务异常。稍后重试；持续出现请提供 request id 联系客服 |
| 504 / 524 | 网关超时 | 生成时间过长。开启流式输出（"stream": true），或调大客户端超时时间 |
对 429、500、502、503、504 可以自动重试，建议使用指数退避（例如 1s、2s、4s，最多 3～5 次）。400、401、403、404 属于请求本身的问题，重试无效。
搜索与阅读 API#
成功时 code 为 0。失败时返回以下结构之一：{ "code": 40001, "data": null, "message": "parameters err" }
{ "error": "Invalid api key" }
| HTTP 状态码 | code / error | 说明与处理 |
|---|
| 400 | 40001 parameters err | 参数缺失或格式错误，例如未传 q、url |
| 400 | 40003 Invalid protocol | URL 协议无效，仅支持 http / https |
| 400 / 500 | 32003 Unsupported content type | 文件或网页的内容类型不支持解析 |
| 401 | Invalid api key | Key 错误，或误用了模型 API Key |
| 403 | search quota exceeded / reader quota exceeded | 搜索或阅读次数已用完，请 购买套餐 |
| 429 | Rate limit exceeded | 超过频率限制，见 速率限制与计费规则 |
| 500 | 32000 Failed to extract content | 无法提取该网页的正文，请更换 URL 或调整 waitUntil |
| 500 | 32001 Target URL is unreachable | 目标网址无法访问 |
| 500 | 32002 Request timeout | 读取超时，可调大 timeout 后重试 |
| 500 | 32004 SSL certificate error | 目标网站 SSL 证书异常 |
| 500 | 50001 internal server error | 服务内部错误，请稍后重试；持续出现请联系客服 |
获取帮助#
联系客服时请提供：账户邮箱、请求时间、request id、完整的错误信息。 
