OpenRouter 入门与概览
OpenRouter 入门与概览
常见问题
3 分钟阅读
常见问题
关于 OpenRouter 的常见问题
入门
为什么应该使用 OpenRouter?
为什么应该使用 OpenRouter?
OpenRouter 提供统一 API,可接入市场上所有主流大语言模型。 它还让用户把账单汇总到一处,并通过我们的分析功能跟踪全部用量。
OpenRouter 透传底层模型服务提供商的定价,同时汇聚它们的可用性, 因此你支付的价格与直接向服务提供商购买相同,同时享有 统一 API 和回退,从而获得高得多的可用性。
如何开始使用 OpenRouter?
如何开始使用 OpenRouter?
如何获得支持?
如何获得支持?
获取技术支持的最佳方式是加入我们的 Discord,并在 #help 论坛向社区提问。
关于计费和账户管理的问题,请发送邮件至 support@openrouter.ai。
定价与费用
使用 OpenRouter 有哪些费用?
使用 OpenRouter 有哪些费用?
购买额度时,OpenRouter 会收取 5.5% ($0.80 minimum) 的手续费。我们透传 底层模型服务提供商的定价,不加价,因此你支付的费率 与直接向服务提供商购买相同。
加密货币支付会收取 5% 的手续费。
使用自己的服务提供商密钥(自带密钥/BYOK)需要付费吗?
使用自己的服务提供商密钥(自带密钥/BYOK)需要付费吗?
需要。如果你选择使用自己的服务提供商 API 密钥(自带密钥, Bring Your Own Key,BYOK),每月前 1M 次 BYOK 请求免费,之后的用量会按同一 模型和服务提供商在 OpenRouter 上的正常费用收取 5% 的手续费。该费用从你的 OpenRouter 额度中扣除。这样你可以在服务提供商侧直接管理速率限制和 成本,同时继续使用 OpenRouter 的统一 接口。
模型与服务提供商
新模型多久添加一次?
新模型多久添加一次?
我们会尽快添加新模型。我们经常与 发布模型的实验室合作,可以在模型可用后尽快上线。 如果有你希望 OpenRouter 支持但尚未上线的模型,欢迎在 Discord 上联系我们。
什么是模型变体?
什么是模型变体?
变体是可以加在模型 slug 后面、用于改变其行为的后缀。
静态变体只能用于特定模型,这些模型会列在我们的 模型 API 中。
动态变体可用于所有模型,它们会改变请求的路由方式或使用方式。
:online(已弃用)- 所有请求都会先执行查询以提取网页结果,并附加到提示词中。请改用openrouter:web_search服务端工具。了解更多。:nitro- 按吞吐量而非默认规则对服务提供商排序,以优化响应速度。了解更多。:floor- 按价格而非默认规则对服务提供商排序,优先选择成本最低的选项。了解更多。:exacto- 使用以工具调用可靠性为优先的质量信号对服务提供商排序。了解更多。
我是推理服务提供商,如何入驻 OpenRouter?
我是推理服务提供商,如何入驻 OpenRouter?
你可以在 服务提供商 页面 阅读我们的要求。如需联系我们,最好 通过电子邮件。
不同模型的预期延迟 / 响应时间是多少?
不同模型的预期延迟 / 响应时间是多少?
OpenRouter 上的每个模型都会展示所有服务提供商的延迟(首 Token 时间)和 Token
吞吐量。你可以用这些数据估算请求耗时。
如果希望针对吞吐量优化,可以使用
:nitro 变体,将请求路由到最快的服务提供商。
如果服务提供商不可用,模型回退如何工作?
如果服务提供商不可用,模型回退如何工作?
如果某个服务提供商返回错误,OpenRouter 会自动回退到 下一个服务提供商。这对用户是透明的,能让生产环境 应用更具韧性。OpenRouter 提供大量选项来配置 服务提供商路由行为。完整文档见 此处。
API 技术规格
支持哪些身份验证方式?
支持哪些身份验证方式?
OpenRouter 使用三种身份验证方式:
- 基于 Cookie 的身份验证,用于 Web 界面和聊天室
- API 密钥(以 Bearer Token 传递),用于访问补全 API 及其他核心端点
- 管理 API 密钥,用于通过密钥管理端点以编程方式管理 API 密钥
速率限制如何计算?
速率限制如何计算?
对于免费模型,速率限制由你已购买的额度决定。 如果你至少购买了 10 额度,免费模型的速率限制为每天 1000 次请求。 否则,你将受限于每天 50 次免费模型 API 请求。
关于付费账户的速率限制如何工作,详见我们的 速率限制文档。
有哪些可用的 API 端点?
有哪些可用的 API 端点?
OpenRouter 实现了 OpenAI API 规范中的 /completions 和 /chat/completions 端点,让你可以用相同的 请求 / 响应格式使用任何模型。另外还提供 /api/v1/models 等 端点。详细规格见我们的 API 文档。
支持哪些格式?
支持哪些格式?
流式传输如何工作?
流式传输如何工作?
流式传输使用服务器发送事件(SSE)实时交付 Token。在请求中设置
stream: true 即可启用流式响应。
有哪些 SDK 支持?
有哪些 SDK 支持?
OpenRouter 是 OpenAI 的即插即用替代。因此,任何默认 支持 OpenAI 的 SDK 也支持 OpenRouter。更多细节见我们的 OpenAI SDK 文档。
隐私与数据记录
使用 API 时会记录哪些数据?
使用 API 时会记录哪些数据?
我们会记录基本的请求元数据(时间戳、所用模型、Token 计数)。提示词 和补全默认不会被记录。即使发生错误,我们也不会记录你的提示词 / 补全, 除非你选择开启记录。
我们提供可选的 设置, 让用户选择记录提示词和补全,以换取用量成本 1% 的折扣。
使用聊天室时会记录哪些数据?
使用聊天室时会记录哪些数据?
聊天室与 API 适用相同的数据隐私。聊天室中的所有对话 都存储在你的本地设备上。对话不会在设备之间同步。 可以使用聊天室设置菜单导出和导入对话。
额度与计费系统
有哪些购买方式?
有哪些购买方式?
OpenRouter 使用额度系统,基础货币为美元。网站和 API 上的 所有定价均以美元标示。用户可以手动为余额充值, 也可以设置自动充值,以便余额低于设定阈值时 自动补足。
额度会过期吗?
额度会过期吗?
根据我们的 条款,我们保留在购买一年后 使未使用额度过期的权利。
我的额度还没有到账
我的额度还没有到账
如果你使用 Stripe 付款,有时 Stripe 集成会出现问题,额度可能延迟显示在账户中。请等待最多一小时。 如果一小时后额度仍未到账,请确认你没有被扣款,并且 没有收到 Stripe 收据邮件。如果你没有收到收据邮件或未被扣款, 你的卡可能被拒绝。请换一张卡或其他支付方式重试。
如果已被扣款但额度仍未到账,请发送邮件至 support@openrouter.ai,并附上购买详情。
如果你使用加密货币付款,请发送邮件至 support@openrouter.ai, 我们会进行排查。
退款政策是什么?
退款政策是什么?
未使用额度的退款,可在交易处理完成后二十四 (24) 小时内申请。如果购买后二十四 (24) 小时内未收到退款申请,任何未使用额度将不可退款。要在符合条件的期限内申请退款,可以使用 额度 页面上的退款按钮。未使用的额度金额将退回你的支付方式;平台手续费不可退款。请注意,加密货币付款一律不可退款。
有哪些免费档选项?
有哪些免费档选项?
批量折扣如何运作?
批量折扣如何运作?
OpenRouter 目前不提供批量折扣,但如果你认为自己有特殊用例, 可以通过电子邮件联系我们。
接受哪些支付方式?
接受哪些支付方式?
我们接受所有主要信用卡、AliPay 以及 USDC 加密货币付款。我们正在集成 PayPal,如果你希望我们支持其他支付 方式,请在 Discord 上联系我们。
OpenRouter 如何盈利?
OpenRouter 如何盈利?
我们在购买额度时收取少量 手续费。我们从不对底层服务提供商的定价加价, 你始终支付与服务提供商标价相同的费用。
账户管理
如何删除账户?
如何删除账户?
前往 设置 页面,点击「管理账户(Manage Account)」。 在打开的对话框中,选择「安全(Security)」标签页。你可以在那里找到删除账户的选项。
请注意,如果你删除账户后又重新创建,未使用的额度将丢失且无法找回。
团队访问如何工作?
团队访问如何工作?
组织管理信息见我们的 组织管理文档。
有哪些分析功能?
有哪些分析功能?
我们的 活动仪表盘 提供实时 用量指标。如果你需要特定报表或指标,请 联系我们。
如何联系支持?
如何联系支持?
关于账户和计费问题,请发送邮件至 support@openrouter.ai。
如何为 OpenRouter 提交错误报告或变更请求?
如何为 OpenRouter 提交错误报告或变更请求?
你可以在我们的 Discord 发帖提交错误报告或变更请求。