> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codeflare.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> 从密钥、地址、协议和请求记录定位问题。

export const ConsoleLink = ({path = "/console", children}) => <a href={"http://localhost:3001" + path} target="_blank" rel="noopener noreferrer">{children}</a>;

## 排查顺序

先记录 HTTP 状态、错误代码、时间、区域、平台模型 ID 和返回的请求/响应标识，再查看 <ConsoleLink path="/console/usage">用量与日志 ↗</ConsoleLink>。分享日志时移除完整密钥与敏感请求内容。

| 现象 | 检查项 |
| - | - |
| 401 / 密钥无效 | 完整密钥、停用/撤销/过期状态、协议鉴权头 |
| 403 / 权限不足 | 密钥是否允许目标模型，以及账号状态 |
| 余额或预算不足 | 账户可用余额、密钥消费上限、输出预算与并发占用 |
| 404 / 模型或路径不存在 | 平台模型 ID、区域地址、重复的 `/v1`、所需协议 |
| 429 / 限流 | 网关/上游限流、并发、响应中的重试提示；先确认执行状态 |
| 502 / 503 / 504 | 路由健康、渠道能力、上游服务、超时或用量异常 |
| 工具无法连接 | 客户端实际 Provider、协议、模型能力和环境变量 |
| 没有可用模型 | 管理员是否完成模型、渠道、路由配置并启用 |

## 中断与取消

断连不是未执行的证明。已保存的 Responses 请求可以在原区域查询；其他情况检查请求记录。终态与真实用量可能分别到达，不要仅凭取消结果推断消费为零。

## 重试与求助

关闭 SDK 自动重试。只有确认上一请求没有执行或明确接受重新生成后，才由应用发起新请求。手选区域不会自动切换到其他区域。

向管理员提供脱敏标识、发生时间和区域；请勿发送完整 API Key。涉及模型权限和费用时以平台记录为准。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.