🛠 接入报错时优先查看
错误排查
如果你在接入过程中遇到 401、404、400、权限不足、余额不足或客户端无内容等问题，建议先按本页给出的顺序排查。大多数问题都可以在地址、Key、模型名、分组权限这 4 项中定位到。
常用入口
优先检查顺序
1. 先检查 Base URL
第三方客户端或 OpenAI SDK 中，Base URL 应填写为：
https://api.fengsuan.online/v1
不要写成根域名，也不要写成完整接口路径。
2. 再检查 API Key
确认请求头是否正确带上：
Authorization: Bearer sk-xxx
同时检查 Key 是否多了一层引号、空格，或复制不完整。
3. 再检查模型名
model 字段必须与模型广场中的展示名称完全一致，不要自行改写。
4. 最后检查余额与分组权限
如果地址、Key、模型名都没问题，再去检查账户余额、令牌额度限制、令牌分组和模型分组是否匹配。
经验上看，大部分客户接入问题并不是服务本身异常，而是 Base URL 填错、Key 填错、模型名写错，或者模型权限不匹配。
常见报错对照表
| 现象 | 常见原因 | 建议处理方式 |
|---|---|---|
| 401 / Unauthorized | API Key 错误、Key 已失效、请求头未带 Bearer | 检查 Authorization: Bearer sk-xxx 是否正确，确认密钥没有多余空格 |
| 404 / Not Found | Base URL 填错、路径少了 /v1、路径拼接错误 |
第三方客户端填写 https://api.fengsuan.online/v1；原生 HTTP 请求使用完整地址 |
| 400 / Bad Request | 请求体格式错误、字段缺失、model 填写错误 | 检查 JSON 格式、model 名称、messages 结构是否正确 |
| 余额不足 | 账户余额不足或令牌额度限制 | 检查钱包余额和令牌额度设置 |
| 模型无权限 | 令牌分组不匹配、模型受限 | 检查令牌所属分组与模型分组要求 |
| 请求成功但客户端无内容 | 客户端解析方式不兼容、流式设置异常 | 先用 curl 或 OpenAI SDK 做最小化测试，再回头检查客户端配置 |
快速处理建议
客户反馈“地址不知道怎么填”
直接让客户填写：
https://api.fengsuan.online/v1
并强调这是 Base URL，不要再额外拼接 /chat/completions。
客户反馈“模型不存在”
让客户去模型广场直接复制模型名，不要自己手动输入或改名。
客户反馈“同一个 Key 在别的客户端能用，这里不能用”
优先判断该客户端的地址填写方式是不是不同。先用 curl 或 OpenAI SDK 验证接口本身是否正常，再排查客户端设置。
客户反馈“有权限但还是报错”
继续检查令牌所属分组、模型限制、账户余额、令牌额度上限和请求体格式。
排查建议：先用最小可用示例测试。只要 curl 或 OpenAI SDK 可以跑通，说明服务端大概率没问题，剩下通常是第三方客户端配置差异。