自带 AI 配置指南

用户可在平台配置自己的 AI 模型接口，用于全站的 AI 问答功能。

1. 为什么配置自带 AI？

对比维度 系统默认 AI 自带 AI（用户配置）
费用承担 平台免费提供 用户服务商按量扣费
每日提问次数 受档位严格限制（Free 5次 / Lite 20次 / Plus 50次 / Pro 100次） 不限次数（仅受底层基础防刷流控）
模型自由度 使用平台统一指定模型 服务商支持的任意模型
全站预算影响 计入平台月度总预算（额满时转工单） 不计入平台预算，永不受平台预算耗尽影响

2. 支持的服务商与协议

平台支持所有遵循 OpenAI 兼容协议（OpenAI-Compatible Chat Completions）的服务商：

3. 配置步骤

进入「用户」→「用户账号（/user）」页面，向下滚动至「自带 AI」模块：

3.1 填写三项必要参数

  1. 接口地址：
    • 必须以 https:// 开头。
    • 填写服务商完整的 API Base URL。例如：
      • OpenAI：https://api.openai.com/v1
      • OpenRouter：https://openrouter.ai/api/v1
      • DeepSeek：https://api.deepseek.com/v1
    • 安全说明：禁止填入内网地址（如 127.0.0.1、192.168.x.x）或回环地址。
  2. 模型名：
    • 填入服务商认可的模型唯一标识符（Model ID）。例如：
      • deepseek-chat
      • gpt-5.5
      • OpenRouter 上用"厂商/模型"格式，以 OpenRouter 模型页显示的 id 为准
  3. API Key：
    • 填入您在对应服务商控制台生成的 API Key。
    • 保存后，网页端出于安全防护仅会显示首尾几位字符（如 sk-ab...12ef）。

3.2 保存与连通性测试

  1. 填好信息后，点击面板右下角「保存」。
  2. 系统在保存时会自动发起一次真实连通性测试：
    • 测试通过：提示“已保存，测试通过”，配置自动处于生效启用状态。
    • 测试未通过：提示“已保存，但测试没通过，已停用”，并在页面显示服务商返回的原样错误原因（如 Key 错误、模型不存在、账户余额不足等）。
  3. 您也可以随时点击「测试」按钮，手动验证当前的连通状态。
  4. 测试通过的配置可以随时勾选或取消「启用」，立即生效；取消后问答改用系统模型。点「删除」可彻底移除配置。

4. 运行期故障处理与自动降级

为确保您的日常使用不被中断，系统具备自动降级保障：

  1. 凭证失效降级： 若使用过程中服务商拒绝请求（401 / 403 / 404：Key 被更换或吊销、模型名不对），系统会：
    • 自动将自带 AI 状态切换为停用；
    • 发送一条站内系统消息通知您更新配置；
    • 问答功能即刻平滑回退至平台系统模型，保证您可继续提问。
  2. 临时网络波动： 超时、服务商 5xx、限流（429）、余额不足属于临时问题：这次提问会报错，配置保持启用，稍后再问即可。
  3. 重新启用： 在服务商处解决账户余额或 Key 问题后，回到「用户账号（/user）」页面重新保存或点击「测试」，通过后即可自动恢复启用。

没找到答案？点右下角「问 AI」，问不到的问题我们会补进手册。