OpenRouter 集成与实践
OpenRouter 集成与实践
Replit
2 分钟阅读
Replit
将 OpenRouter 与 Replit Agent 和 Replit Apps 配合使用
将 OpenRouter 与 Replit 配合使用
Replit 让你可以直接在浏览器中构建、部署和托管应用。你可以通过两种方式将 OpenRouter 与 Replit 配合使用:
- Replit Agent(BYOK,自带密钥),在 Replit Agent 为你构建 AI 功能时使用你自己的 OpenRouter API 密钥,而不是 Replit 托管的默认密钥。
- Replit Apps(项目 Secrets),在任意 Replit App 中将 OpenRouter API 密钥存为 Secret,并从代码中调用 OpenRouter。
关于 Replit 托管 AI 选项的背景,见 Replit 的 AI Integrations 文档。
前提条件
你需要一个 OpenRouter API 密钥。在 openrouter.ai/keys 创建一个,并复制该密钥(以 sk-or-v1- 开头)。
在 Replit Agent 中使用你的 OpenRouter API 密钥
默认情况下,当 Replit Agent 检测到你的提示词需要 AI 功能时,它会使用 Replit 托管的凭证,并将用量计入你的 Replit 账户。若你更希望使用自己的 OpenRouter 账户(以便直接计费、自定义速率限制,或访问更广泛的模型),可以自带 API 密钥。
对于新的 Replit Apps
提交用于创建新应用的初始提示词时,请说明你想使用自己的 OpenRouter API 密钥。例如:
构建一个聊天应用,使用我自己的 OpenRouter API 密钥。
在 Agent 的回复中,提供商名称将不再带有 “(Replit managed)” 后缀,这表示 Agent 会向你请求 OpenRouter API 密钥。Agent 通常会构建到第一个检查点,然后提示你输入密钥。
对于现有的 Replit Apps
当 Agent 检测到你想为现有应用添加 AI 功能时,会显示确认提示,询问是否使用带有 Replit 托管凭证的 Replit AI Integrations。若要改为直接使用 OpenRouter:
- 在集成提示上点击 Dismiss(关闭)。
- 让 Agent 构建到第一个检查点。
- 当 Agent 询问 API 密钥时,粘贴你从 openrouter.ai/keys 获取的 OpenRouter 密钥。
Agent 会将该密钥存为项目中的 Secret(通常名为 OPENROUTER_API_KEY),并将其接入生成的代码。
将 OpenRouter API 密钥添加为 Replit Secret
若你自己在 Replit App 中编写代码(不经过 Agent),请将 OpenRouter API 密钥添加为项目 Secret,以便在运行时作为环境变量可用。
- 打开你的 Replit App。
- 在左侧边栏打开 Secrets 工具(看起来像一把挂锁图标)。
- 点击 New Secret(新建密钥)。
- 将 Key 设为
OPENROUTER_API_KEY。 - 将 Value 设为你的 OpenRouter API 密钥(例如
sk-or-v1-...)。 - 点击 Add Secret(添加密钥)。
该密钥现在可作为 process.env.OPENROUTER_API_KEY(Node.js)或 os.environ["OPENROUTER_API_KEY"](Python)供你的应用使用。Secrets 不会暴露在源文件中,并且按项目隔离。
从代码中调用 OpenRouter
配置好 Secret 后,你可以使用任何兼容 OpenAI 的 SDK,将其指向 https://openrouter.ai/api/v1 来调用 OpenRouter。
框架相关示例(Vercel AI SDK、LangChain、Anthropic SDK 等)见框架与集成概览。
Replit Deployments 与 Teams
当你将 Replit App 发布为 Deployment 时,在 Replit App 中配置的 Secrets 会带到已部署的应用。若要在不重新部署代码的情况下轮换密钥,请在 Deployment 的设置中更新 OPENROUTER_API_KEY Secret。
对于 Replit 上的 Teams 和企业组织,组织管理员控制是否启用 Replit AI Integrations。若已禁用(或你更希望不使用 Replit 托管凭证),每位成员仍可按上述步骤自带 OpenRouter API 密钥。