OpenRouter 集成与实践

OpenRouter 集成与实践

Replit

2 分钟阅读

Replit

将 OpenRouter 与 Replit Agent 和 Replit Apps 配合使用

将 OpenRouter 与 Replit 配合使用

Replit 让你可以直接在浏览器中构建、部署和托管应用。你可以通过两种方式将 OpenRouter 与 Replit 配合使用:

  1. Replit Agent(BYOK,自带密钥),在 Replit Agent 为你构建 AI 功能时使用你自己的 OpenRouter API 密钥,而不是 Replit 托管的默认密钥。
  2. 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:

  1. 在集成提示上点击 Dismiss(关闭)。
  2. 让 Agent 构建到第一个检查点。
  3. 当 Agent 询问 API 密钥时,粘贴你从 openrouter.ai/keys 获取的 OpenRouter 密钥。

Agent 会将该密钥存为项目中的 Secret(通常名为 OPENROUTER_API_KEY),并将其接入生成的代码。

使用你自己的 OpenRouter API 密钥产生的用量由 OpenRouter 计费,而不是 Replit。你可以在 API Keys 页面监控支出并设置按密钥的限额。

将 OpenRouter API 密钥添加为 Replit Secret

若你自己在 Replit App 中编写代码(不经过 Agent),请将 OpenRouter API 密钥添加为项目 Secret,以便在运行时作为环境变量可用。

  1. 打开你的 Replit App。
  2. 在左侧边栏打开 Secrets 工具(看起来像一把挂锁图标)。
  3. 点击 New Secret(新建密钥)。
  4. Key 设为 OPENROUTER_API_KEY
  5. Value 设为你的 OpenRouter API 密钥(例如 sk-or-v1-...)。
  6. 点击 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。

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
});

const completion = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-4.5",
  messages: [{ role: "user", content: "来自 Replit 的问候!" }],
});

console.log(completion.choices[0].message);

框架相关示例(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 密钥。

资源