这是做什么的
「AI模型」管理 AI 的服务来源：也就是网站去调用哪家 AI（供应商）、用哪把钥匙（API密钥）、能用哪些模型。
- 供应商：提供 AI 服务的厂商，如 OpenAI、DeepSeek、百度文心。
- API密钥：访问供应商的"通行证"（一串很长的字符）。没有密钥，AI 无法工作。
- 模型：供应商提供的具体型号，如 deepseek-chat。AI 应用要在这些模型里挑一个来用。
页面的列表以供应商为主，一家供应商下面挂着它的密钥和模型。新增、编辑都在同一个表单里完成。
在哪里操作（菜单路径 + 截图占位）
左侧主菜单 →【AI应用】→ 子菜单【AI模型】。
页面地址形如 ?route=ai/model。
【此处插入：AI模型 → 供应商列表页截图】
如果页面顶部出现黄色提示"系统检测到还没有配置任何 API 密钥……"，说明还没配密钥，请先按下面步骤配好，否则 AI 功能全都用不了。
操作前准备
- 已登录后台。
- 从 AI 服务商官网申请到 API Key（密钥）和 API 基础地址。常见地址：DeepSeek 为
https://api.deepseek.com/v1，OpenAI 为https://api.openai.com/v1。 - 想清楚要登记几家供应商、各要开放哪些模型。
新增（分步操作）
在列表页点右上角【添加模型】，逐项填写：
- 供应商名称（必填）：如"DeepSeek"。
- 供应商代码（必填，保存后不可改）：唯一标识，如
deepseek、openai。重复会提示"供应商代码已存在"。 - API基础地址：如
https://api.deepseek.com/v1。填错会导致调用失败。 - 状态：默认【启用】。停用后该供应商及其模型都无法被调用。
- 排序：数字越小越靠前（默认 50）。
- 高级配置（点开箭头）→ 扩展配置：选填，JSON 格式，如
{"supports_json_schema":true,"endpoints":{"text":"/chat/completions"}}。 - API 密钥（带 * 号，至少填一把）：
- 点【添加密钥】增加一行。
- 密钥别名：仅用于区分多把钥匙，随便填，如"主号"。
- API密钥：粘贴服务商给的密钥。若供应商代码填了
baidu，还会多一个【百度 Secret Key】输入框，一并填写。 - 点该行的【高级选项】可展开【过期时间】（留空=永久有效）与【扩展配置】。
- 该行【删除】可去掉这一把密钥。
- 模型（下方表格）：
- 点【添加模型】增加一行。
- 模型名称：展示名，如"DeepSeek-V3"。
- 模型代码：调用时真正使用的名称，如
deepseek-chat。名称与代码都填才会保存。 - 点【高级选项】可填【上下文长度】与【最大输出 token 数】。
- 该行【删除】可去掉该模型。
- 点【提交】保存。若没有填任何一把有效密钥，会提示"请至少添加一把有效的API密钥"。
编辑 / 修改
- 列表里点供应商名称，或点该行【编辑】，进入编辑页。
- 供应商代码不可修改（灰底只读）。
- 改密钥：在"API 密钥"区对应行的【API密钥】框输入新值即替换；留空表示不修改（框内有占位提示"已配置-输入新值可替换"）。
- 加/改模型：在"模型"区直接增行或改行。
- 重置密钥失败计数：若某把钥匙失败次数大于 0，行尾会出现【重置】，点击后把失败计数清零。
- 改完点【提交】。供应商、密钥、模型会一次性保存。
删除 / 批量操作
- 删除单条（供应商）：该行点【删除】，确认后删除。以下情况无法删除并会给出原因：
- 该供应商存在会话记录 / 使用日志；
- 该供应商下的模型已被 AI 应用引用。
- 删除密钥 / 模型：在编辑页对应行点【删除】；保存后才真正生效（新增未保存的行直接点删除即可移除）。
- 批量操作：勾选多个供应商，列表下方下拉框可选【启用所选供应商】【停用所选供应商】【删除】，点【执行】。
- 快捷开关：状态列小标签可直接点击切换启用/停用。
列表页常用操作
- 筛选：顶部输入框按【供应商名称/供应商代码】搜索，点【筛选】。
- 列表列：记录号、供应商名称、供应商代码、API密钥（显示数量，未配置显示感叹号可点击进入编辑页）、API基础地址、状态、排序、创建时间、操作。
常见问题 / 小贴士
- AI 调用报"无可用的AI模型配置"？ 多半是没配密钥，或供应商/模型被停用了。
- "API基础地址"填什么？ 每家服务商不同，务必照官方文档填，尤其注意结尾要不要
/v1。 - 密钥安全：密钥以明文存储在数据库中，请确保服务器与数据库访问安全，不要外泄截图。
- 一把密钥能用多久？ 取决于服务商；可填【过期时间】提醒自己，过期后及时更换。
- 一家供应商能放多把密钥吗？ 可以，失败时会自动切换，提高稳定性。