管理端配置
模型与额度
本页用于初始化可被 Runtime 调用的模型、为模型设置 Credits 换算,并为成员分配周期额度。
完成哪些配置
本页用于初始化可被 Runtime 调用的模型、为模型设置 Credits 换算,并为成员分配周期额度。必须先验证模型可用性,再将模型授予角色和用户。
配置模型
- 进入 System → Models(
/admin/settings/model),选择系统预置的 Model Group。当前版本不能创建、复制或删除 Model Group。 - 填写当前页面要求的 Base URL、API Key 等连接信息并保存;敏感凭证仅在受控管理页填写。
- 在该组中添加或编辑 Model,填写
Model Display Name、Model ID、Logo、Context Window、能力信息(如Supports Image Parsing)及 Credits Conversion。 - 保存后执行
Test connection;仅在测试成功、Model Group 与 Model 都启用且显示配置有效时,模型才成为可授权候选。 - 到 Account → Roles 的
Allowed models显式授予目标角色,并以普通用户账号完成最小测试消息验证。
配置 Credits Conversion
界面单位为 credits / 1K tokens,输入、输出和缓存命中 Token 应分别配置。先确认统一结算货币、每 Credit 的货币价值 V 及供应商价格;若价格以“货币/1M tokens”计:
Credits / 1K tokens = P / (1000 × V)
保存前反算每种 Token 的每 Credit 货币价值,除零价格场景外应保持一致。截图中的示例值不是默认值,不能直接复用。
配置 Credits Plan 与额外额度
- 进入 System → Credits → Plan management(
/admin/settings/credits?tab=plan-management)。 - 选择
New create plan,填写必填的Plan name、Billing period、Period limit、Daily credit limit,并在 Members 中选择成员。 - 保存后核对计划状态为
Active或页面明确的可用状态,以及周期、每日上限和成员范围。 - 需要临时追加时,进入 Account → Accounts,在成员的
...中选择Grant extra credits,选择作用于周期或每日额度,填写数值和Valid until,并检查历史记录。
单个账户同一时间只能有一个生效 Credits Plan;切换计划后旧计划的周期与每日用量不转入新计划,新计划从 0 开始统计。Extra credits 不会修改原计划。
异常处理与 QA
测试连接成功后,为什么用户仍不能选择模型?
测试成功只是可用条件之一。继续检查 Model Group、Model 的启用状态、显示配置和用户角色的 Allowed models。
能否把一个模型的 Credits 比例复制给另一个模型?
不能。输入、输出、缓存价格和货币换算均可能不同,必须按各自供应商价格计算并反向校验。
计划成员的额度显示不正确怎么办?
先检查成员当前唯一生效的计划、切换时间和每日/周期额度;不要通过发放额外额度掩盖计划本身的错误。