故障排查
按现象快速定位。
按错误码
| 现象 | 最可能原因 | 下一步 |
|---|---|---|
| 401 无效令牌 | 令牌错/删/未带 | 核对 Authorization，重粘令牌 |
| 403 无权限 | 模型未对分组开放 / 令牌白名单 | 查 /v1/models，找管理员开权限 |
| 404 model not found | 模型名拼错或不存在 | 对照模型价格页 |
| 429 频繁 | 超频/超并发 | 退避重试，降速 |
| 额度不足 | 额度用尽 | 充值/换令牌 |
| 502/503/504 | 上游渠道故障/超时 | 稍后重试，找管理员查渠道 |
按现象
调用没反应 / 卡住
多为长输出未用流式而客户端超时。改用 stream=true 并设置合理超时。
中文乱码 / 截断
确保以 UTF-8 传输；检查是否触及 max_tokens 导致 finish_reason=length。
SDK 报 base_url 相关错误
确认填的是 https://ai.moespark.dev/v1（多数 SDK 需要 /v1 前缀），且允许 HTTP/2 或标准 TLS。
浏览器里直接调用失败
受 CORS 限制且会暴露密钥，请改为后端调用。
最小复现模板
curl -sS https://ai.moespark.dev/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"ping"}]}' -i把 -i 的完整响应（含状态码与 x-oneapi-request-id）发给管理员可快速定位。