本地 API 端点

如果您或您的团队自建了 AI API 服务（例如企业内网的私有化部署），可以通过开发者模式将 WinCode 指向您自己的 API 地址，而不使用默认的云端服务。

什么是本地 API 端点

默认情况下，WinCode 通过卫宁健康的云端服务进行 AI 对话。本地 API 端点功能允许您将这个服务地址替换为您自己的 API 服务。这在以下场景中非常有用：

• 企业要求所有数据请求不得离开内网。
• 团队部署了自有的 AI 模型服务，希望统一接入。
• 需要对 API 调用进行审计和流量控制。

配置步骤

第一步：确认您的 API 服务就绪

在配置之前，请确保您的 API 服务满足以下条件：

• 服务已启动并可正常响应请求。
• WinCode 所在设备可以通过网络访问该服务地址。
• 了解您的服务所使用的请求格式（通常需要兼容标准 API 协议）。

第二步：在 WinCode 中配置端点

1. 打开 WinCode，进入 设置 > 开发者模式。
2. 找到 API 端点 区域。
3. 将默认的云端地址替换为您自己的 API 地址，例如：
   • http://192.168.1.50:3000/api/v1
   • https://ai.yourcompany.com/api
4. 如果您的 API 需要认证，在 API 密钥 一栏中填入您的密钥或 Token。
5. 点击 保存并测试连接。

WinCode 会向该地址发送一个测试请求。如果返回成功，说明配置正确；如果失败，请检查地址和网络连通性。

第三步：验证使用

配置完成后，回到 WinCode 主界面，发起一次对话。如果对话正常响应，说明本地 API 端点已经生效。

您可以在状态栏查看当前使用的 API 端点地址，确认请求确实发往了您的本地服务。

切换回默认云端

如果需要恢复使用默认的云端服务：

1. 进入 设置 > 开发者模式 > API 端点。
2. 点击 恢复默认。
3. WinCode 会自动切回官方云端服务地址。

多个端点配置

WinCode 支持保存多个 API 端点配置，方便在不同环境之间切换（例如公司内网、家庭网络、测试环境等）。

1. 在 API 端点 区域，点击 添加新端点。
2. 为端点取一个便于识别的名称（如"公司内网"、"测试环境"）。
3. 填入对应的地址和认证信息。
4. 保存后，可以通过下拉菜单在已保存的端点之间快速切换。

注意事项

• 地址格式：确保地址包含完整的协议前缀（http:// 或 https://），不要以斜杠结尾。
• 网络安全：如果使用 HTTP（非加密），请确保该端点仅在受信任的内网中使用，避免 API 密钥被截获。
• 兼容性：本地 API 端点需要兼容标准的对话 API 格式。如果您的自建服务格式不同，可能需要中间适配层。
• 故障影响：如果本地 API 服务不可用，WinCode 的对话功能将无法工作。请确保服务有足够的可用性。

相关文档

• 开发者模式概览
• 网关与 Sidecar
• 故障排查