服务商与模型

接入你自己的服务商密钥(11 家内置服务商,或任意 OpenAI 兼容端点),并为每个功能分配模型。

Cordy 采用自带密钥。你接入一个自己已在使用的服务商 API 密钥,Cordy 便直接从你的浏览器调用该服务商——中间没有 Cordy 代理,也没有账号。你可以同时接入多个服务商,并为每个功能分配不同的模型。

内置服务商

Cordy 内置 11 家云端服务商。每家都有预填的默认 Base URL(可覆盖)和一个掩码的 API 密钥字段。请在服务商自己的控制台创建密钥;其文档会说明具体方法。

服务商文档说明
OpenRouteropenrouter.ai/docs一个密钥即可使用多家厂商的模型
OpenAIplatform.openai.com/docsGPT 系列模型
Anthropicdocs.anthropic.comClaude 系列模型
Googleai.google.dev/docsGemini 系列模型(Google AI Studio)
xAIdocs.x.aiGrok 系列模型
Vercel AI Gatewayvercel.com/docs/ai-gateway一个密钥统管多家服务商;Base URL 固定
火山方舟(Volcengine Ark)volcengine.com/docs/82379国内区域模型;服务商卡片标注为 火山方舟
DeepSeekapi-docs.deepseek.com2.5.5 新增
Qwen (Alibaba Cloud Model Studio)help.aliyun.com/zh/model-studio2.5.5 新增,即阿里云百炼;默认 Base URL 为中国内地端点(dashscope.aliyuncs.com)
Groqconsole.groq.com/docs2.5.5 新增
Mistral AIdocs.mistral.ai2.5.5 新增

你不需要全部接入——一家即可开始。OpenRouter 是不错的首选,因为一个密钥就能解锁众多模型。

自定义 OpenAI 兼容服务商

除内置项外,你还可以在自定义服务商区(位于仪表盘)添加自己的 OpenAI 兼容端点。为它设置显示名称、Base URL 和 API 密钥,然后逐行键入你想使用的模型 ID。可用模型以手动填写的模型列表为准。这涵盖自托管网关以及任何遵循 OpenAI API 的服务。

检查模型目录会向该端点请求模型列表,但仅供诊断。检查失败时 Cordy 会提示,你手动填写的模型仍可使用(自 2.5.5 起)。

对于像 Ollama、LM Studio 这类通过本地回环运行的本地运行时,请改用专门的本地原生运行时设置——见 本地与设备端 AI。

添加密钥

API 密钥在仪表盘的服务商目录和编辑器中管理。

  1. 从侧边栏顶部打开仪表盘,进入 设置 → AI 配置 → 服务商配置。
  2. 搜索或浏览服务商目录,打开一个服务商,把密钥粘贴进 API 密钥字段,并可按需调整 Base URL。离开输入框时密钥即会保存。
  3. 点击检测以验证连接。状态徽标会更新为可用、不可用、检测中或未配置,检测成功还会刷新该服务商的模型列表。
  4. 对你想接入的其他服务商重复上述步骤。

如果某个服务商显示为已配置,但其密钥之后变为缺失或无法读取(例如随浏览数据一起被清除),Cordy 会显示内联警告,请你重新输入。

分功能模型路由

不同任务可以使用不同模型。在设置 → AI 配置 → 功能模型中,Cordy 为支持的功能提供独立槽位:

  • 对话——主对话模型。
  • 翻译——供划词菜单、命令面板和翻译操作使用。
  • 解释——供「解释」使用。
  • 总结——供「总结」使用。
  • 朗读 (TTS)——语音合成引擎与音色(见 朗读)。

对每个文本槽位,你选择一个服务商与模型。聊天槽位还有上下文上限——标准(200K)(取模型窗口与 200K 中较小者,为默认值)或自动最大(模型的完整窗口)。一个槽位可以指向云端服务商、自定义端点或本地运行时。

模型限制

自 2.5.7 起,Cordy 按以下顺序获取每个模型的上下文大小与输出上限:服务商自身的模型列表(仅限 OpenRouter、Groq、Google、Mistral AI 与火山方舟;其他服务商报告的数值会被忽略)、公开的 Vercel AI Gateway 模型目录、公开的 LiteLLM 模型目录。如果都没有该模型的信息,上限视为未知,由各功能采用自己的回退值;例如翻译此时假定上下文窗口为 32,768 个 token、输出上限为 8,192 个 token。这些目录缓存在本地,大约每天刷新一次。下载请求不携带密钥或个人数据;隐私政策列出了这些目录。

聊天中切换模型

你无需打开设置即可更换模型。输入框会显示当前模型——点击它即可为当前对话搜索并切换。模型选择器支持搜索(Esc 清除搜索),且只显示模型名,不带厂商前缀。当你需要添加密钥时,侧边栏中紧凑的路由卡片会链接到完整的仪表盘设置。

本地与设备端模型

你可以把支持的槽位路由到本机模型:Chrome 内置 Gemini Nano、通过 WebGPU 运行的浏览器内 Gemma,或 Ollama、LM Studio、llama.cpp、vLLM、LocalAI、Unsloth 等 OpenAI 兼容运行时。翻译不提供本地原生端点选项;其本地选项使用浏览器内引擎。设置与要求见本地与设备端 AI。

密钥安全

  • 密钥先加密,再写入 Cordy 的 IndexedDB 安全存储;加密密钥不可导出,服务商密钥不会作为明文设置保存。
  • 请求直接发往你所配置的服务商。Cordy 不运行任何后端,也绝不接触你的流量。
  • 删除服务商密钥是数据管理中的单独操作。密钥不包含在数据备份中,因此恢复备份后需要重新输入。

完整数据模型见 隐私与权限。

疑难排查

  • 「需要密钥」/ 未列出模型。 该服务商尚未配置,或检测未成功。请重新检查密钥和 Base URL。
  • 添加密钥后「暂无可用模型」。 点击检测刷新目录;对于自定义端点,请确认你已手动键入模型 ID。
  • 「模型目录检查失败;手动添加的模型仍可使用」。 自定义端点没有返回模型列表。你手动填写的模型不受影响。
  • 模型拒绝了某个参数。 部分模型不支持每个选项;请尝试其他模型或服务商。
  • 密钥「缺失」警告。 你存储的密钥被清除或损坏——请在服务商配置中重新输入。

相关