OpenRouter 为不同供应商的语言模型提供统一 API。Deskgram 2 内置了该服务商，并为支持选择 OpenRouter 的 AI 模块提供独立密钥字段。
连接 OpenRouter
- 在 OpenRouter 账户中获取 API 密钥。
- 保存到 Deskgram API 设置中的 OpenRouter 字段。
- 在所需 AI 模块中选择 OpenRouter。
- 选择账户可用的模型；必要时保存密钥后刷新模型列表。
- 先通过可用的 AI 测试发送简短请求，再运行主要任务。
OpenRouter 用量与 Deskgram 订阅分别计费。检查余额及模型条件；免费模型也可能存在配额和可用性限制。
模型与参数选择
使用与你需要的回复、评论或对话相同的语言和长度进行测试。参数取决于模块和模型。若参数被拒绝或没有文本回复，先使用短请求和基础设置，再逐项增加要求。
从 OpenRouter 目录复制准确的模型标识。名称相近不代表价格、上下文或功能相同。
API 地址
官方基础地址是 https://openrouter.ai/api/v1，使用 Bearer 认证。Deskgram 内置服务商已设置该地址，通常只需填写密钥并选择模型。
无需为了重复内置配置而添加自定义服务商。如果使用自定义设置，请确认字段需要基础 URL 还是完整方法地址；重复添加 /chat/completions 会产生错误路径。
与 MCP 的区别
模型 API 负责生成文本。智能体通过 MCP 连接 Deskgram 时，需要独立的地址、令牌和权限。OpenCode 可以使用模型服务并调用 MCP，但 Deskgram 中保存的密钥不会自动传给它。
错误与数据
认证失败时，确认没有误用 MCP 令牌。余额不足或超出配额时，检查账户和密钥限制。模型不可用时刷新目录。输出不符时，简化语言、长度和格式要求。响应速度也受外部服务商影响。
请求会发送到外部服务。使用真实对话之前，请检查模块发送了哪些数据，以及所选模型的数据处理条款。
文档
参考 OpenRouter 入门文档、模型目录 和 Deskgram 服务目录。
条款与说明
由服务商单独计费. 按钮直接访问官方网站，不含推荐代码。本指南不代表与服务开发者存在官方合作关系。
设置核对日期：2026年10月20日。