Affected area
Model routing / providers
Problem or use case
目前后台无法直接测试某个上游模型、平台模型或路由绑定是否可用。管理员只能在聊天中实际选择模型后尝试发送消息,排查成本较高,也不方便区分是上游配置、模型名称、协议、鉴权、路由绑定还是网络问题。
希望能像 Cherry Studio 一样,在模型配置完成后直接测试模型是否可用。
Proposed behavior
在后台模型相关页面增加模型测试能力(以下仅供参考):
- 上游模型、平台模型或路由绑定处提供“测试”操作。
- 测试时使用当前配置的协议、模型名称、Base URL、Key、参数和路由规则发起一次轻量请求。
- 测试结果展示:
- 是否成功
- 响应耗时
- 使用的协议
- 上游返回的错误摘要
- 经过脱敏的请求/响应调试信息
- 测试失败时给出更明确的错误原因,例如:
- 鉴权失败
- 模型不存在
- 协议不匹配
- 上游不可用
- 请求参数不支持
- 响应格式不兼容
- 测试过程不应暴露 API Key、Authorization header 或敏感 Base URL。
- 图片、语音、视频等非聊天模型可以根据协议提供对应的最小化测试方式,无法测试的协议应明确提示原因。
Alternatives considered
手动进入聊天页面选择模型并发送消息,但这种方式无法快速定位配置问题,也不适合管理员批量验证上游模型可用性。
Compatibility, deployment, or migration impact
Configuration changes: None expected.
API changes: May require a new admin-only model test endpoint.
Database migrations: None expected.
Deployment changes: None expected.
Backward compatibility: Existing model routing and provider configuration should remain unchanged.
Documentation or API contract impact
需要补充模型测试接口说明、测试范围、错误码含义以及敏感信息脱敏规则。
Pre-submit checklist
Affected area
Model routing / providers
Problem or use case
目前后台无法直接测试某个上游模型、平台模型或路由绑定是否可用。管理员只能在聊天中实际选择模型后尝试发送消息,排查成本较高,也不方便区分是上游配置、模型名称、协议、鉴权、路由绑定还是网络问题。
希望能像 Cherry Studio 一样,在模型配置完成后直接测试模型是否可用。
Proposed behavior
在后台模型相关页面增加模型测试能力(以下仅供参考):
Alternatives considered
手动进入聊天页面选择模型并发送消息,但这种方式无法快速定位配置问题,也不适合管理员批量验证上游模型可用性。
Compatibility, deployment, or migration impact
Configuration changes: None expected.
API changes: May require a new admin-only model test endpoint.
Database migrations: None expected.
Deployment changes: None expected.
Backward compatibility: Existing model routing and provider configuration should remain unchanged.
Documentation or API contract impact
需要补充模型测试接口说明、测试范围、错误码含义以及敏感信息脱敏规则。
Pre-submit checklist