常见问题¶
1. 返回 401 未授权¶
原因： API Key 错误或未传递
解决方法： - 检查 API Key 是否正确
2. 返回 404 接口不存在¶
原因： API 地址错误
解决方法： - 检查接口 URL 是否正确 - 确认是否使用正确版本路径（如 /v1/）
3. 请求超时¶
原因： 网络延迟或模型响应慢
解决方法： - 检查服务器网络，使用外部大模型平台 需要服务器可以连接外网。
4. 内置配置参数能不能修改¶
内置了主流的 AI 平台的参考配置参数，可以根据实际情况自行修改
5. Model 怎么选择¶
选择一个文本类，速度快的，非思考模式的模型，或者价格低的
6. 如何使用其他 AI¶
选择 User-defined 自己定制参数，参数根据 AI 平台说明，Url 链接一般是 base_url + /v1/chat/competions，下图就是使用美团的 LongCatAI 开放平台设置：
7. 使用本地部署的大模型¶
如果大模型服务器硬件配置高可以使用，数据安全好、纯内网也可以使用、没有 API 调用次数限制、没有 Token 计费；需要有一个兼容 OpenAI Chat API 接口的本地服务，选择 User-defined 自己定制参数：
8. 使用外部大模型数据安全吗¶
使用外部大模型，邮件内容数据会提交给大模型平台，如果信息安全有合规要求，可以考虑另外自己部署本地开源大模型，或者联系大模型服务商做本地化部署。
9. 后台配置豆包大模型时出错¶
检查 Url、Model、API Key 参数，确定正确，豆包的 Url 地址默认是 https，在 Windows 7、2008r2、2012 上要改成 http
10. 自定义的 User-defined 能不能改名¶
可以自己修改 Winmail 安装目录里的 ~/server/data/aiapi.cfg 文件， 修改前先备份一下，使用文本编辑器工具软件打开，修改以下部分内容，其他不变。注意重新安装 Winmail 或者升级新版本时这个文件会恢复原样，需要再次修改。这个文件里也可以增加多个自定义的服务商。
<item>
<name>User-defined</name>
<url></url>
<model></model>
</item>
例如改成
<item>
<name>美团-LongCat</name>
<url>https://api.longcat.chat/openai/v1/chat/completions</url>
<model>LongCat-Flash-Lite</model>
</item>
