OpenRouter 集成与实践

OpenRouter 集成与实践

Infisical

2 分钟阅读

Infisical

使用 Infisical 自动轮换 API 密钥

Infisical 是一个密钥管理平台，帮助团队在基础设施中安全地存储、同步和轮换密钥。借助 Infisical 的 OpenRouter 集成，你可以按计划自动轮换 API 密钥，通过零停机轮换确保凭证安全。

前提条件

在设置 API 密钥轮换之前，你需要一个 OpenRouter Management API 密钥。管理密钥是仅用于密钥管理操作（创建、列出、删除密钥）的特殊密钥，不能用于模型补全请求。

创建 OpenRouter Management API 密钥

前往 OpenRouter Settings，进入 Management API Keys 部分。点击 Create New Key（创建新密钥），完成密钥创建流程，并复制生成的 Management API 密钥。请妥善保存，创建 Infisical 连接时会用到。

OpenRouter Management Keys 页面，显示 Create Management Key 按钮

关于 Management API 密钥和密钥管理的更多细节，见 OpenRouter 的 Management Keys 文档。

设置 OpenRouter 连接

第一步是在 Infisical 中创建将用于管理 API 密钥的 OpenRouter 连接。

在 Infisical 中创建连接

在 Infisical 控制台中，前往 Organization Settings，然后进入 App Connections（或项目中的 App Connections 页面）。点击 Add Connection（添加连接），并从可用连接列表中选择 OpenRouter。

使用上一步的 OpenRouter Management API Key、可选描述，以及连接名称（例如 “openrouter-production”）填写表单。点击 Create（创建）后，Infisical 会针对 OpenRouter 的 API 验证该密钥，随后连接即可使用。

带截图的详细说明见 Infisical 的 OpenRouter Connection 文档。

配置 API 密钥轮换

连接设置完成后，即可配置自动 API 密钥轮换。

创建 API 密钥轮换

在 Infisical 中前往 Secret Manager 项目的 Dashboard，从操作下拉菜单中选择 Add Secret Rotation（添加密钥轮换）。选择 OpenRouter API Key 选项。

Infisical 控制台，显示 Add Secret Rotation 选项

配置轮换行为

设置密钥应如何以及何时轮换：

Auto-Rotation Enabled（启用自动轮换）控制是否按间隔自动轮换密钥。关闭后仅手动轮换，或临时暂停轮换。

Rotate At（轮换时刻）指定间隔到期后，轮换在当天本地时间的何时运行。

Rotation Interval（轮换间隔）设置触发轮换的间隔天数。

OpenRouter Connection（OpenRouter 连接）选择将在轮换期间创建和删除 API 密钥的连接（带有 Management API 密钥）。

设置 API 密钥参数

配置被轮换 API 密钥的属性：

Key name（密钥名称）是该密钥在 OpenRouter 中的显示名称（必填）。

Limit（限额）为该密钥设置可选的美元消费限额。

Limit reset（限额重置）决定限额多久重置一次：每天、每周或每月。

Include BYOK in limit（限额中包含 BYOK）是一项可选设置，控制来自你自有提供商密钥（自带密钥，Bring Your Own Key）的用量是否计入该密钥的消费限额。禁用时，只计入 OpenRouter 额度。启用时，BYOK 用量计入限额。

映射到 Secret 名称

指定用于存储被轮换 API 密钥的 Secret 名称。这是 Infisical 中可访问被轮换 API 密钥值的 Secret 名称。

完成设置

为轮换指定名称和可选描述，然后检查配置并点击 Create Secret Rotation（创建密钥轮换）。你的 OpenRouter API Key 轮换现已激活。当前 API 密钥作为 Secret 可在映射路径上使用；轮换会创建新密钥、将活动 Secret 切换到新密钥，然后撤销旧密钥，以实现零停机轮换。

完整 API 参考和更多选项，见 Infisical 的 OpenRouter API Key Rotation 文档。

理解 BYOK 与限额

OpenRouter 上的 BYOK（自带密钥，Bring Your Own Key）让你可以使用自己的提供商 API 密钥（例如 OpenAI 或 Anthropic），从而直接向提供商付费，同时 OpenRouter 对这些请求收取少量费用。

Include BYOK in limit（限额中包含 BYOK）控制 BYOK 用量是否计入密钥的消费限额。禁用时，只有 OpenRouter 额度用量计入限额，BYOK 用量单独跟踪。启用时，来自你自有提供商密钥的用量计入限额；一旦达到限额，该密钥在下次重置前将受 OpenRouter 速率限制约束。

更多细节见 OpenRouter BYOK 文档 和 OpenRouter 限额文档。

了解更多

上一页Zapier