OpenRouter

OpenRouter是什么

OpenRouter 是一个统一 AI 模型 API 与供应商路由平台。开发者只需创建一个账户和 API Key，就能通过相对统一的接口调用来自不同厂商的文本、推理、视觉、图像、音频和 Embedding 模型，并在同一控制台查看用量、成本、延迟和错误。

OpenRouter 本身不是一个大模型，也不保证每个模型由同一家基础设施运行。它把模型与多个推理提供商连接起来，并根据价格、吞吐、延迟、可用性、隐私政策和用户指定顺序选择端点。具体能力、上下文、内容政策、地区可用性和单价会随模型及供应商变化。

OpenRouter核心功能

统一多模型API

OpenRouter 提供 OpenAI 风格的 Chat Completions、Responses、Embeddings 等接口，也支持 Anthropic Messages 方向。许多现有应用只需修改 Base URL、API Key 和模型 ID 即可接入。官方还提供 Python、TypeScript、Go 等 SDK 与示例，但不同模型并不支持完全相同的工具、图片、音频、推理参数和结构化输出。

模型与供应商聚合

同一模型可能由多个供应商提供推理。默认路由会在可用端点之间平衡可靠性与性能，出现限流或故障时可以回退到其他提供商。开发者也可指定供应商顺序、禁止回退、限制量化级别，或按价格、吞吐和延迟选择端点。

回退能提高成功率，但可能改变延迟、数据处理方、地区和输出细节。对合规或结果一致性要求高的应用，应固定允许的供应商和参数，并记录实际命中的模型、端点与生成 ID。

模型路由与自动选择

OpenRouter 提供自动路由、模型路由和预设，可根据输入内容或可用性选择模型。它适合在大量模型之间快速试验，也能把低成本模型用于简单请求，把更强模型留给复杂任务。自动选择不代表质量最优，生产系统仍应通过评估集验证准确率、稳定性和成本。

BYOK自带供应商密钥

BYOK 允许用户添加自己在 OpenAI、Anthropic、Google、AWS 等供应商的密钥，同时继续使用 OpenRouter 的统一接口与路由。密钥会加密保存，可设置为优先使用或仅在共享容量失败后作为回退；默认情况下，自带密钥失败后仍可能使用 OpenRouter 余额，若要彻底避免回退，需要开启对应限制。

BYOK 的模型费用由原供应商账户结算，OpenRouter 还会按官方规则收取平台费。免收费额度按对应模型在 OpenRouter 的标价推理成本计算，不是简单按请求次数计算。

预算与用量控制

控制台可查看请求、Token、费用、延迟和错误，并为 API Key 或团队设置预算与支出限制。Management API Key 可用于自动创建和管理子密钥。正式环境应为项目和开发者分配独立密钥，设置额度、允许来源和轮换策略，避免共享主密钥。

隐私与数据策略路由

每个推理提供商都有自己的日志、保留和训练政策。OpenRouter 会展示端点的数据政策，用户可以在账户或请求级别禁止路由到可能使用提示词训练的提供商，也可以要求 Zero Data Retention 兼容端点。此设置只控制可选择的供应商，不能替代阅读 OpenRouter 自身与模型供应商的条款。

企业客户可申请美国或欧盟区域路由，使请求在选定区域处理。区域能力并非所有账户或模型默认提供，需要企业开通并核对可用模型清单。

缓存与成本优化

平台支持供应商级提示词缓存，也提供 OpenRouter 层的相同响应缓存。启用响应缓存后，匹配同一 API Key、模型、端点、流式方式和请求体的成功请求可以直接返回缓存结果，缓存命中不计费。默认缓存时间较短，可按请求或预设调整。

缓存会返回原有结果，不适合每次必须生成新内容的场景。账户级 Zero Data Retention 启用时，响应缓存不可用，因为缓存需要短期保存返回数据。

Chat与模型试用

网页端 Chat 可用于比较模型、测试提示词和附件能力。免费模型可直接试用，但存在每日请求限制、供应商容量和可用性变化。免费模型更适合体验与开发验证，不能默认视为具有付费模型同等的 SLA、吞吐或隐私承诺。

OpenRouter套餐与费用对比

OpenRouter 当前分为 Free、Pay-as-you-go 和 Enterprise。模型本身按各模型页面展示的输入、输出、图片、音频、搜索或请求单价计费；平台费和 BYOK 规则另算。动态模型价格不应被写成永久固定价，调用前可通过模型 API 或控制台读取当前价格。

OpenRouter BYOK费用对比

这里的 25,000 或 200,000 美元不是赠送余额，而是按同模型/供应商在 OpenRouter 上的标价计算的免平台费 BYOK 推理量。超过阈值后，5% 费用从 OpenRouter credits 扣除，因此 BYOK 用户仍需保留足够平台余额。

OpenRouter API接入教程

1. 注册并创建Key：在控制台生成项目专用 API Key，不要把密钥放进前端代码、公开仓库或截图。
2. 充值或选择免费模型：测试阶段可使用免费模型；正式调用先购买 credits 并设置预算上限。
3. 读取模型列表：确认模型 ID、输入输出类型、上下文、工具能力和当前价格，不要只凭模型名称猜测。
4. 修改客户端配置：使用兼容 SDK 时，把 Base URL 指向 OpenRouter，传入密钥和完整模型 ID。
5. 发送测试请求：先测试文本与流式输出，再逐项验证工具、图片、JSON Schema 和推理参数。
6. 设置路由策略：按业务要求指定供应商、是否回退、价格或性能排序，以及隐私政策条件。
7. 处理错误：针对限流、余额不足、内容拒绝、供应商故障和上下文超限分别处理，不要无限重试。
8. 监控上线：记录实际模型、供应商、Token、成本、延迟和生成 ID，并设置密钥预算与告警。

计费与成本注意事项

不同模型可能按输入 Token、输出 Token、内部推理 Token、缓存读写、图片、音频、网页搜索或单次请求分别收费。长上下文和推理模型可能出现显著额外成本。客户端估算 Token 只适合预算参考，最终应以 API 返回的 usage 与控制台账单为准。

余额充值、退款、税费和支付方式按所在地区与结算页执行。免费模型、价格、供应商和限流可能随时调整；面向用户提供服务时应建立自己的限额、成本保护和降级策略。

OpenRouter适合哪些用户

• 希望通过一个接口快速比较和切换多种大模型的开发者；
• 需要在多个供应商之间回退，提高 API 可用性的应用团队；
• 想使用 OpenAI 兼容客户端接入不同文本与多模态模型的用户；
• 需要统一预算、日志、密钥和模型成本管理的组织；
• 已有供应商账户，希望通过 BYOK 使用统一路由层的团队。

优势与使用限制

OpenRouter 的优势是模型覆盖广、接入方式统一、可比较实时价格与性能，并提供路由、回退、BYOK、预算和数据政策过滤。它能明显降低多模型原型和供应商切换的工程成本。

聚合层也会增加一个依赖与数据处理环节。模型参数和响应并非完全可互换，供应商切换可能带来结果变化；服务可用性仍受上游影响。对敏感数据应限定允许端点和区域，检查日志与保留条款。模型输出可能错误或违规，OpenRouter 不替代内容审核、事实核验和业务风控。

常见问题

OpenRouter免费吗

有免费方案，当前提供多种免费模型并限制为 50 次请求/天。付费模型按实际用量计费，Pay-as-you-go 另有 5.5% 平台费。

OpenRouter是模型吗

不是。它是模型聚合、统一 API 与供应商路由平台，回答由所选择的上游模型生成。

OpenRouter兼容OpenAI SDK吗

大多数聊天调用可以通过修改 Base URL、密钥和模型 ID 接入。不同模型的高级参数与能力仍需按文档测试。

OpenRouter支持BYOK吗

支持，可添加自己的供应商密钥并设置优先或回退顺序。BYOK 有按月免平台费阈值，超出后按当前规则收取 5%。

OpenRouter会用提示词训练吗

不同供应商政策不同。用户可禁止路由到会训练数据的端点或要求 ZDR，但仍需分别阅读平台与实际供应商的数据条款。