Cherry Studio
文档

OpenRouter

OpenRouter 是一个 统一网关,用一把 key 接入 200+ 家厂商的对话模型(GPT、Claude、Gemini、Llama、DeepSeek 等),按 token 转计费,适合多模型对比 / 没法一一注册各家账号的用户。

获取 API Key

  • 前往 OpenRouter 注册账号
  • Settings → KeysCreate Key,复制 sk-or-... 密钥
  • 充值任意金额(最低 $1)

在 Cherry Studio 配置

  • 打开 设置 → 模型服务,找到 OpenRouter Provider 进入详情页
  • API 密钥 填入 sk-or-...
  • API 地址 默认 https://openrouter.ai/api,无需修改
  • 点击 获取模型列表,OpenRouter 会返回数百个可用模型

推荐用法

OpenRouter 的模型 ID 形如 <vendor>/<model>

模型 ID 示例实际是谁
openai/gpt-4oOpenAI GPT-4o
anthropic/claude-sonnet-4Anthropic Claude Sonnet 4
google/gemini-2.0-flashGoogle Gemini Flash
meta-llama/llama-3.3-70b-instructMeta Llama 3.3 70B
deepseek/deepseek-chatDeepSeek V3
x-ai/grok-4xAI Grok

适用场景

  • 多模型 A/B 对比:在同一 Cherry Studio Provider 下随意切模型,无需切 Provider
  • 避免一一注册:一个 key 一个发票就能用 200+ 模型
  • 冷门模型:很多小厂商只在 OpenRouter 上提供(如 Cohere、Reka 等)

原生联网与网址读取

OpenRouter 的对话模型可使用原生网络搜索和 URL 内容读取。选择模型时查看名称旁的 🌐 图标,并在对话输入栏打开 🌐。

如果【设置】→【网络搜索】中的【优先使用已配置的搜索服务】保持开启,Cherry Studio 会优先使用外部搜索服务;关闭该选项后,才会优先使用 OpenRouter 的模型原生能力。服务商可能对联网请求单独计费,实际费用以 OpenRouter 账单为准。

与 Anthropic 协议的关系

OpenRouter 默认走 OpenAI 协议格式封装所有上游模型。这意味着:

  • ✅ 普通对话、知识库、快捷助手都可用
  • ⚠️ Cherry Agent 建议直接用 Anthropic / CherryIN,不要走 OpenRouter(Agent 需要 Anthropic 原生协议)

获取帮助与提交反馈

如果您在配置或使用过程中遇到任何疑问、Bug 或有功能改进建议,请参考 反馈与建议 中提供的官方渠道。

本页内容