OpenRouter 入门与概览

OpenRouter 入门与概览

常见问题

3 分钟阅读

常见问题

关于 OpenRouter 的常见问题

入门

OpenRouter 提供统一 API,可接入市场上所有主流大语言模型。 它还让用户把账单汇总到一处,并通过我们的分析功能跟踪全部用量。

OpenRouter 透传底层模型服务提供商的定价,同时汇聚它们的可用性, 因此你支付的价格与直接向服务提供商购买相同,同时享有 统一 API 和回退,从而获得高得多的可用性。

在快速开始指南中了解更多

首先,创建账户并在 额度 页面充值。额度就是 你在 OpenRouter 上用于大语言模型推理的预存款。 当你使用 API 或聊天界面时,我们会从额度中扣除请求费用。 每个模型和每个服务提供商每百万 Token 的价格不同。

有额度之后,你可以使用聊天室,也可以创建 API 密钥 并开始调用 API。代码示例和更多内容见我们的 快速开始企业 指南。

获取技术支持的最佳方式是加入我们的 Discord,并在 #help 论坛向社区提问。

关于计费和账户管理的问题,请发送邮件至 support@openrouter.ai

每个模型都会展示每百万 Token 的定价。提示词 Token 和补全 Token 的价格通常不同。也有按请求、按图像以及按推理 Token 计费的模型。 这些细节都会显示在模型页面上。

当你向 OpenRouter 发出请求时,我们会收到服务提供商处理的 Token 总数, 然后计算相应费用并从你的额度中扣除。 你可以在 活动标签页 查看完整用量历史。

我们透传底层服务提供商的定价;推理价格没有加价 (但购买额度时会收取 手续费)。

定价与费用

购买额度时,OpenRouter 会收取 5.5% ($0.80 minimum) 的手续费。我们透传 底层模型服务提供商的定价,不加价,因此你支付的费率 与直接向服务提供商购买相同。

加密货币支付会收取 5% 的手续费。

需要。如果你选择使用自己的服务提供商 API 密钥(自带密钥, Bring Your Own Key,BYOK),每月前 1M 次 BYOK 请求免费,之后的用量会按同一 模型和服务提供商在 OpenRouter 上的正常费用收取 5% 的手续费。该费用从你的 OpenRouter 额度中扣除。这样你可以在服务提供商侧直接管理速率限制和 成本,同时继续使用 OpenRouter 的统一 接口。

了解更多关于自带密钥(BYOK)

模型与服务提供商

OpenRouter 可接入种类丰富的大语言模型,包括来自主要 AI 实验室的前沿模型。 完整列表可在 模型浏览器 查看,或通过 模型 API 获取。

我们会尽快添加新模型。我们经常与 发布模型的实验室合作,可以在模型可用后尽快上线。 如果有你希望 OpenRouter 支持但尚未上线的模型,欢迎在 Discord 上联系我们。

变体是可以加在模型 slug 后面、用于改变其行为的后缀。

静态变体只能用于特定模型,这些模型会列在我们的 模型 API 中。

  1. :free - 该模型始终免费提供,但速率限制较低。了解更多
  2. :extended - 该模型的上下文长度比通常更长。了解更多
  3. :thinking - 该模型默认支持推理。了解更多

动态变体可用于所有模型,它们会改变请求的路由方式或使用方式。

  1. :online(已弃用)- 所有请求都会先执行查询以提取网页结果,并附加到提示词中。请改用 openrouter:web_search 服务端工具了解更多
  2. :nitro - 按吞吐量而非默认规则对服务提供商排序,以优化响应速度。了解更多
  3. :floor - 按价格而非默认规则对服务提供商排序,优先选择成本最低的选项。了解更多
  4. :exacto - 使用以工具调用可靠性为优先的质量信号对服务提供商排序。了解更多

你可以在 服务提供商 页面 阅读我们的要求。如需联系我们,最好 通过电子邮件。

OpenRouter 上的每个模型都会展示所有服务提供商的延迟(首 Token 时间)和 Token 吞吐量。你可以用这些数据估算请求耗时。 如果希望针对吞吐量优化,可以使用 :nitro 变体,将请求路由到最快的服务提供商。

如果某个服务提供商返回错误,OpenRouter 会自动回退到 下一个服务提供商。这对用户是透明的,能让生产环境 应用更具韧性。OpenRouter 提供大量选项来配置 服务提供商路由行为。完整文档见 此处

API 技术规格

OpenRouter 使用三种身份验证方式:

  1. 基于 Cookie 的身份验证,用于 Web 界面和聊天室
  2. API 密钥(以 Bearer Token 传递),用于访问补全 API 及其他核心端点
  3. 管理 API 密钥,用于通过密钥管理端点以编程方式管理 API 密钥

了解更多关于 API 身份验证

对于免费模型,速率限制由你已购买的额度决定。 如果你至少购买了 10 额度,免费模型的速率限制为每天 1000 次请求。 否则,你将受限于每天 50 次免费模型 API 请求。

关于付费账户的速率限制如何工作,详见我们的 速率限制文档

OpenRouter 实现了 OpenAI API 规范中的 /completions 和 /chat/completions 端点,让你可以用相同的 请求 / 响应格式使用任何模型。另外还提供 /api/v1/models 等 端点。详细规格见我们的 API 文档

API 支持文本、图像和 PDF。 图像 可以以 URL 或 base64 编码图像的形式传入。PDF 也可以作为 URL 或 base64 编码数据发送,并且适用于 OpenRouter 上的任何模型。

流式传输使用服务器发送事件(SSE)实时交付 Token。在请求中设置 stream: true 即可启用流式响应。

了解更多关于流式传输

OpenRouter 是 OpenAI 的即插即用替代。因此,任何默认 支持 OpenAI 的 SDK 也支持 OpenRouter。更多细节见我们的 OpenAI SDK 文档

查看所有支持的框架和集成

隐私与数据记录

请参阅我们的 服务条款隐私政策

我们会记录基本的请求元数据(时间戳、所用模型、Token 计数)。提示词 和补全默认不会被记录。即使发生错误,我们也不会记录你的提示词 / 补全, 除非你选择开启记录。

我们提供可选的 设置, 让用户选择记录提示词和补全,以换取用量成本 1% 的折扣。

了解更多关于数据收集

聊天室与 API 适用相同的数据隐私。聊天室中的所有对话 都存储在你的本地设备上。对话不会在设备之间同步。 可以使用聊天室设置菜单导出和导入对话。

OpenRouter 是一个代理,会把你的请求发送给模型服务提供商以完成推理。 我们会尽可能与所有服务提供商合作,确保提示词和补全不会被记录或用于训练。 会进行记录的服务提供商,或我们无法确认其政策的服务提供商,不会被路由到,除非你在 隐私设置 标签页中打开了模型训练开关。

如果你在请求中指定了 服务提供商路由,但没有任何服务提供商 符合你账户设置中的隐私级别,你将收到错误,请求不会完成。

了解更多关于服务提供商的记录政策

额度与计费系统

OpenRouter 使用额度系统,基础货币为美元。网站和 API 上的 所有定价均以美元标示。用户可以手动为余额充值, 也可以设置自动充值,以便余额低于设定阈值时 自动补足。

根据我们的 条款,我们保留在购买一年后 使未使用额度过期的权利。

如果你使用 Stripe 付款,有时 Stripe 集成会出现问题,额度可能延迟显示在账户中。请等待最多一小时。 如果一小时后额度仍未到账,请确认你没有被扣款,并且 没有收到 Stripe 收据邮件。如果你没有收到收据邮件或未被扣款, 你的卡可能被拒绝。请换一张卡或其他支付方式重试。

如果已被扣款但额度仍未到账,请发送邮件至 support@openrouter.ai,并附上购买详情。

如果你使用加密货币付款,请发送邮件至 support@openrouter.ai, 我们会进行排查。

未使用额度的退款,可在交易处理完成后二十四 (24) 小时内申请。如果购买后二十四 (24) 小时内未收到退款申请,任何未使用额度将不可退款。要在符合条件的期限内申请退款,可以使用 额度 页面上的退款按钮。未使用的额度金额将退回你的支付方式;平台手续费不可退款。请注意,加密货币付款一律不可退款。

活动 页面允许用户查看 历史用量,并按模型、服务提供商和 API 密钥筛选。

我们还提供 额度 API,可获取 账户余额和剩余额度的实时信息。

所有新用户都会获得少量免费额度,用于试用 OpenRouter。 OpenRouter 上提供许多 免费模型。 这些模型的速率限制较低(总计每天 50 次请求), 通常不适合生产使用。如果你至少购买了 10 额度, 免费模型将限制为每天 1000 次请求。

你也可以使用 免费模型路由器openrouter/free)自动为请求选择免费模型。

OpenRouter 目前不提供批量折扣,但如果你认为自己有特殊用例, 可以通过电子邮件联系我们。

我们接受所有主要信用卡、AliPay 以及 USDC 加密货币付款。我们正在集成 PayPal,如果你希望我们支持其他支付 方式,请在 Discord 上联系我们。

我们在购买额度时收取少量 手续费。我们从不对底层服务提供商的定价加价, 你始终支付与服务提供商标价相同的费用。

账户管理

前往 设置 页面,点击「管理账户(Manage Account)」。 在打开的对话框中,选择「安全(Security)」标签页。你可以在那里找到删除账户的选项。

请注意,如果你删除账户后又重新创建,未使用的额度将丢失且无法找回。

组织管理信息见我们的 组织管理文档

我们的 活动仪表盘 提供实时 用量指标。如果你需要特定报表或指标,请 联系我们。

关于账户和计费问题,请发送邮件至 support@openrouter.ai

你可以在我们的 Discord 发帖提交错误报告或变更请求。