配置模型

摘要

Bot 可使用套餐模型积分或自有服务商凭证。可以设置一个主模型、多个备用模型，也可仅保存模型。API Key 在服务商后台创建，不由 LightVela 生成。

先确认套餐是否已包含可用模型

部分 LightVela 套餐包含可直接使用的模型及模型积分。若当前套餐权益有效、仍有可用额度，且所需模型在套餐支持范围内，可先在网页对话中使用，无需先填写自己的 API Key。 可用模型、额度、有效期及消耗规则以当前套餐与模型页面为准；并非所有套餐都包含所有模型。

需要套餐之外的模型，或希望使用自己的服务商额度时，再按下文配置。这里的套餐内置模型与「模型 Coding Plan」页签中的第三方模型套餐不同：后者需要相应服务商的 API Key。

开始前

登录后选择目标 Bot，打开「管理 → 模型」。确认 Bot 已就绪；网页对话无需先连接聊天通道。使用自有模型时，准备有效的 Key 和服务商额度。

配置模型

1. 选择「模型 Coding Plan」「模型 API」或「自定义模型」页签，再选择服务商。
2. 若有「点此获取 API Key」外链，在服务商后台创建 Key，回到 LightVela 填入。
3. 选择目录中的模型；服务商支持在线发现时，可点击「获取可用模型」。
4. 点击「检测模型状态」，选择用途并「确认配置」，等待保存结果及用途标记。

自定义模型还需填写 Provider 名称、Base URL，并按实际端点选择 OpenAI Chat Completions、Anthropic Messages 或 OpenAI Responses。模型列表出现条目不等于调用一定成功。

检查与管理

「检测模型状态」展示本次检测结果、模型、端点、响应时间或错误。保存后，在网页对话发送简短消息验证。一次检测成功不代表持续可用。

展开已配置服务商可以追加模型并保存。模型行可设为主模型、设置或取消备用，以及删除模型；删除服务商下最后一个模型时也会移除该服务商配置。步骤见模型切换。

常见问题

遇到 401 时核对 Key、端点、协议、地域和套餐类型；Coding Plan 与普通 API 的凭证可能不同。保存结果不明确时刷新核对，避免连续提交。对话仍失败时检查额度及诊断中心。