开通并配置 OpenRouter API

最后核对：2026-09-21。 OpenRouter 汇集了多家模型服务，但每个模型仍可能有自己的价格、上下文长度和地区限制。配置前请以模型详情页和付款页的实时信息为准。

OpenRouter 适合希望用一个 API Key 尝试多家模型的新手。你不需要分别维护每一家服务商的 Base URL，但使用费用、可用模型和数据策略仍由 OpenRouter 及实际提供模型的上游共同决定。

什么时候选择 OpenRouter

你的情况	建议
想用一个 Key 尝试不同厂商的模型	适合使用 OpenRouter
必须直接与模型原厂签约、开票或满足企业合规	优先使用对应原厂 API
只想使用 ChatGPT、Claude 等网页产品	不需要配置 OpenRouter API

1. 注册账号

打开 OpenRouter 官网，选择 Sign in。
按页面提供的方式登录并完成账号验证。
登录后打开 Models 模型目录，确认想使用的模型当前可用。

OpenRouter 没有一份适用于所有上游模型的固定地区清单。某个模型的提供商可能单独限制国家、地区、组织或使用场景，请以注册页、付款页、模型详情和相关条款的实际显示为准，不要绕过地区限制。

2. 购买 API Credits

打开 Credits 页面，按页面提示购买余额，也可以根据自己的预算设置自动充值。

付款前注意：

Credits 使用美元计价，模型按实际输入、输出等用量扣费；
不同模型和上游线路价格可能不同，调用前查看模型详情；
付款手续费、最低购买额、退款窗口和 Credits 有效期可能调整；
免费模型也可能有每日请求数和频率限制，不适合作为稳定生产额度。

实时规则见 OpenRouter Pricing、FAQ 和 Terms。

3. 创建 API Key

打开 API Keys。
选择创建新 Key，名称可以填写 EasyAI-Mac 或 EasyAI-Windows。
如果页面提供 Credit limit，按自己的预算设置该 Key 的支出上限。
创建后立即保存完整 Key。

完整 Key 只应保存在你自己的设备上。怀疑泄露时，立即在 Keys 页面禁用或删除旧 Key，并创建新 Key。

4. 选择模型 ID

打开 Models 模型目录，进入模型详情页并复制完整的模型 slug。它通常带有厂商前缀，例如 厂商/模型名。

不要填写网页上的简称、聊天产品套餐名，或删掉模型名前面的厂商部分。模型是否免费、支持哪些能力及当前价格都可能变化，应以该模型详情页为准。

5. 在 EasyAI 中怎么填

打开目标 Agent 的 配置 API → 添加服务商：

字段	填写内容
服务商名称	`OpenRouter`
API 类型	`OpenAI Chat Completions`
Base URL	`https://openrouter.ai/api/v1`
API Key	OpenRouter Keys 页面创建的完整 Key
默认模型	Models 页面中的完整模型 slug
启用此服务商	开启

OpenRouter 的新手教程以 OpenAI 兼容的 Chat Completions 接口为主，因此 EasyAI 首次配置建议选择 OpenAI Chat Completions。只有目标模型和 Agent 都明确支持 Responses 时，才切换到 OpenAI Responses。

保存后选择 配置生效，再执行 重新检测。检测成功只表示当前 Key 和地址可访问；开始会话后如果模型报错，再检查模型 slug、余额和上游可用状态。

官方请求示例和接口说明见 OpenRouter Quickstart。

常见问题

提示或状态	常见原因与处理方法
`400`	参数或模型名不正确。先从 Models 页面重新复制完整 slug
`401`	Key 缺失、复制不完整、已禁用或已删除
`402`	Credits 不足，或该 Key 已达到你设置的 Credit limit
`403`	账号、模型、内容策略或上游提供商不允许当前请求
`429`	达到免费额度、平台保护限制或上游模型的速率限制
`502`	当前选择的模型或上游线路调用失败，稍后重试或更换模型
`503`	暂时没有满足当前路由要求的可用提供商

完整说明见 OpenRouter 错误与排障和 API 限制。需要确认某个 Key 的余额与限制时，可以按官方文档查询 Key 信息。