故障排查

先做最小请求

先确认 DNS、TLS 和密钥：

bash

curl -i https://freedomz.cn/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

如果模型列表成功，再测试不带工具、附件和实验参数的最小对话请求。

401 认证失败

确认请求头格式为 Authorization: Bearer ...。
检查密钥是否有空格、换行或被撤销。
不要连续切换多个密钥或账号重试。
停止自动任务并联系支持检查账户状态。

403 请求被拒绝

检查请求是否触发内容政策、上游安全策略或地区限制。
不要通过改写、编码、分段或提示注入规避安全机制。
删除敏感内容后重新评估业务用途。
对误判提交脱敏后的请求结构和请求 ID。

429 请求过多

降低并发和请求频率。
使用指数退避，例如 2、4、8、16 秒，设置最大次数。
避免多个工作进程同时立即重试。
检查单个任务是否形成循环调用。

5xx 或连接中断

保留请求 ID、时间和模型名称。
对幂等请求进行有限重试。
工具调用、支付或其他可能产生副作用的请求，重试前先确认是否已执行。
流式连接中断时，不要把已生成内容和完整请求无条件重复提交。

请求很慢

用 /v1/models 区分网络问题和模型推理耗时。
检查客户端代理、DNS、TLS 和读取超时。
降低输入长度、工具数量和并发。
不要因为单个请求慢而无限并行提交同一任务。

提交支持信息

请提供：

北京时间和时区；
接口路径、模型、状态码；
请求 ID；
客户端和 SDK 版本；
是否流式、重试次数；
脱敏后的最小请求结构。

不要提交完整密钥、密码、Cookie 或包含个人敏感信息的完整提示词。