服务商与模型
接入你自己的服务商密钥（OpenRouter、OpenAI、Anthropic、Google、xAI、Vercel AI Gateway、火山方舟，或任意 OpenAI 兼容端点），并为每个功能分配模型。
Cordy 采用自带密钥。你接入一个自己已在使用的服务商 API 密钥，Cordy 便直接从你的浏览器调用该服务商——中间没有 Cordy 代理，也没有账号。你可以同时接入多个服务商，并为每个功能分配不同的模型。
内置服务商
Cordy 内置七家云端服务商。每家都有预填的默认 Base URL（可覆盖）和一个掩码的 API 密钥字段。
| 服务商 | 在哪里获取密钥 | 说明 |
|---|---|---|
| OpenRouter | openrouter.ai | 一个密钥即可访问跨厂商的 100+ 模型 |
| OpenAI | platform.openai.com | GPT 系列模型 |
| Anthropic | console.anthropic.com | Claude 系列模型 |
| aistudio.google.com | Gemini 系列模型（Google AI Studio） | |
| xAI | console.x.ai | Grok 系列模型 |
| Vercel AI Gateway | vercel.com | 一个密钥统管多家服务商；Base URL 固定 |
| 火山方舟（Volcengine Ark） | volcengine.com | 国内区域模型；服务商中心卡片标注为 火山方舟 |
你不需要全部接入——一家即可开始。OpenRouter 是不错的首选，因为一个密钥就能解锁众多模型。
自定义 OpenAI 兼容服务商
除内置项外，你还可以在自定义 Provider区（位于仪表盘）添加自己的 OpenAI 兼容端点。为它设置显示名称、Base URL 和 API 密钥，然后逐行键入你想使用的模型 ID——自定义端点不会自动发现模型，因此需要你自行列出。这涵盖自托管网关以及任何遵循 OpenAI API 的服务。
对于像 Ollama、LM Studio 这类通过本地回环运行的本地运行时，请改用专门的本地原生运行时设置——见 本地与设备端 AI。
添加密钥
API 密钥在仪表盘的服务商中心管理。
- 打开仪表盘（从侧边栏顶部进入），进入 设置 → AI 配置 → API 服务商。
- 找到你的服务商卡片。把密钥粘贴进 API 密钥字段（会被掩码），并可按需调整 Base URL。
- 点击检测以验证连接。状态徽标会更新为可用、不可用、检测中或未配置，检测成功还会刷新该服务商的模型列表。
- 对你想接入的其他服务商重复上述步骤。
如果某个服务商显示为已配置，但其密钥之后变为缺失或无法读取（例如随浏览数据一起被清除），Cordy 会显示内联警告，请你重新输入。
分功能模型路由
不同任务值得不同的模型——聊天用大模型，翻译用快速廉价的模型。在设置 → AI 配置 → 场景模型路由中，Cordy 为每个功能提供独立的槽位：
- 对话——主对话模型。
- 翻译——供划词菜单、命令面板和翻译操作使用。
- 解释——供「解释」使用。
- 总结——供「总结」使用。
- 书签分类——用于自动归类书签。它有一个跟随聊天模型开关（默认开启）；关闭后可为分类单独指定模型。
- 朗读 (TTS)——语音合成引擎与音色（见 朗读）。
对每个文本槽位，你选择一个服务商与模型，并可选上下文上限——标准（200K）（取模型窗口与 200K 中较小者）或自动最大（模型的完整窗口）。一个槽位可以指向云端服务商、自定义端点或本地运行时。
聊天中切换模型
你无需打开设置即可更换模型。输入框会显示当前模型——点击它即可为当前对话搜索并切换。模型选择器支持搜索（Esc 清除搜索），且只显示模型名，不带厂商前缀。当你需要添加密钥时，侧边栏中紧凑的路由卡片会链接到完整的仪表盘设置。
本地与设备端模型
你可以把任意槽位路由到在你机器上运行的模型，而非云端——Chrome 内置的 Gemini Nano、通过 WebGPU 在浏览器内运行的 Gemma 模型，或你自己通过本地回环运行的本地运行时（Ollama、LM Studio、llama.cpp、vLLM、LocalAI）。设置与要求见 本地与设备端 AI。
密钥安全
- 密钥经 Cordy 的安全存储加密后仅保存在本机——绝不明文写入设置，也绝不上传。
- 请求直接发往你所配置的服务商。Cordy 不运行任何后端，也绝不接触你的流量。
- 移除密钥或扩展会在本地删除它。密钥不包含在数据备份中，因此恢复备份后需要重新输入。
完整数据模型见 隐私与权限。
疑难排查
- 「需要密钥」/ 未列出模型。 该服务商尚未配置，或检测未成功。请重新检查密钥和 Base URL。
- 添加密钥后「暂无可用模型」。 点击检测刷新目录；对于自定义端点，请确认你已手动键入模型 ID。
- 模型拒绝了某个参数。 部分模型不支持每个选项；请尝试其他模型或服务商。
- 密钥「缺失」警告。 你存储的密钥被清除或损坏——请在服务商中心重新输入。