Dashboard 模型

要更换默认对话模型，或补上图片、视频与语音能力，打开 Dashboard 的 Models。这里保存 Profile 默认路由；已有对话的模型选择需要在该会话中另行修改。

从哪张卡片开始

anyy dashboard

进入 Models 后按任务选择：

想做什么	分类/卡片
先接通日常对话	Text → Main model
增加故障时的备用目标	Text → Add fallback
理解或生成图片	Image
理解视频	Video
配置听写和声音回复	Voice → STT/TTS

卡片会显示 provider/model，以及 primary、enabled、disabled、unavailable 等状态。卡片状态和目录条目不能确认实际生成，需要保存后在对话里另做验证。

把一条连接配完整

点击 Main model，页面会根据当前服务商契约显示真实可用的字段：

1. 选择 Provider 类型；
2. 如果有多个服务或协议，选择对应 Service 和 Protocol；
3. 选择认证方式；
4. 输入 API Key，或完成支持的订阅登录；
5. 保留默认 Base URL，或填写可信的兼容地址；
6. 刷新模型目录，必要时切换成手动输入模型 ID；
7. 选择模型和默认推理设置；
8. 用 Test connection 检查目录可访问、所选模型存在，然后 Save；
9. 新建 Chat 会话，核对选中的 provider/model，发送“请回复：连接已确认”，确认收到真实回答。验证时暂时停用已配置 fallback，测后恢复原设置；若保留 fallback，则必须核实回答实际来自所测目标且未回退。选择器显示目标名称并收到回复，还不能单独证明该目标生成成功。

右侧配置预览只展示非敏感设置。已经保存的 API Key 不会以明文完整显示。

目录检查和真实回答分开确认

更改 Provider、Endpoint、凭据或模型后，可以用 Test connection 检查待保存设置或已保存凭据对应的目录。这个按钮只查目录连通和模型是否存在，不执行对话生成；显示 connected 后，仍要按上面的新会话步骤确认实际回答。

API Key 与订阅登录

同一详情页会根据服务商提供相应操作：

• 新增或替换 API Key；
• 清除已保存的 Key；
• 发起或重新进行 OAuth/订阅登录；
• 退出当前订阅账号。

认证与具体 Endpoint 绑定。切换服务或协议后，可用凭据范围和模型目录也可能变化。Codex 使用订阅设备登录；Anthropic 的 Claude Code 订阅选项接受外部取得的 setup token，不能据此推断所有 OAuth 服务都可用。目录和登录成功仍需分别验证实际模型请求。

当前五类对话协议及未实现的其他原生协议见服务商协议与模型接口。

什么时候需要 Fallback

在 Text 分类点击 Add fallback，配置独立 provider/model，检查目录后保存。再到新会话明确选中这个目标，发一条短提示，并按主模型相同方式停用 fallback 或确认回答未回退，测后恢复原设置。备用卡片上的目录检查不能代替这一步。

fallback 按保存顺序尝试。每一项可以启用/停用，并控制：

• 是否允许丢弃目标无法回放的推理历史；
• 是否允许使用更小上下文窗口；
• 该 fallback 的最大尝试次数（包括该目标的第一次尝试）。

不再需要的目标应进入详情页明确移除。

fallback 是可用性路由

它不会同时询问多个模型，也不会合并多个答案。它是在错误策略允许且目标兼容时，为运行时提供有顺序的替代路径；工具、媒体、推理历史和上下文要求可能使某项被跳过。Session 自动重试和 Provider SDK 重试另行控制。

给图片和视频选择路径

如果主模型目录明确声明支持相应输入，图像理解和视频理解可以自动走主模型；否则需要选择专用 provider/model。

理解类路由还可以设置：

• 功能启用状态；
• auto 或 summary_first；
• 专用提示词；
• Token/字符上限；
• 超时；
• thinking 行为。

summary_first 必须有专用路由。手动填写的未知模型不会被 Anyy 自动视为具有图片或视频能力，应先测试。

图像生成属于输出路由，有自己的 provider/model、默认宽高比、超时和字节上限。产品图像生成目前要求 OpenAI Responses，不能仅凭普通 OpenAI-compatible Chat Endpoint 工作；它与 Codemode 的 openrouter-images 模型接口分别配置。

听写与声音回复

Voice 中包含：

• TTS：Provider、模型、协议、音色、自动语音行为和试听；
• STT：Provider、模型、协议、默认语言和连接测试。

文本对话可用，并不意味着该服务商的语音 Endpoint 也可用。TTS 协议为 audio-speech 或 chat-audio-output；STT 为 audio-transcriptions 或 chat-audio-input。填写 API 根地址，并让协议匹配模型。只启用已经测试通过的路由，详见语音与听写。

保存后到哪里验证

Dashboard 通过当前 Gateway 保存配置。新建会话使用已保存的主模型；已有 Chat 会话可能保留自己的 provider/model 与推理状态，直到你在会话里切换或新建会话。

需要纯终端设置方式，请阅读模型配置。

常见问题

现象	处理方法
模型列表为空	检查认证与 Base URL，再点 Refresh models
Test connection 失败	核对 Endpoint、凭据、模型 ID 和账号权限
Main model 显示 unavailable	核对详情里的目录连接和保存路由，再在新 Chat 会话验证生成
显示 connected，聊天却失败	connected 只说明目录检查成功；查看真实生成错误，核对模型权限、Endpoint 和凭据
图片/视频要求专用模型	主模型未声明对应输入能力，或选择了 summary_first
Chat 里看不到刚保存的模型	新建会话，或在当前会话明确切换
订阅状态过期	重新认证；必要时先退出，再连接正确账号