Stripe 项目

使用 Stripe 项目 CLI 将 OpenRouter 添加到你的应用

Stripe 项目（Stripe Projects）是基于命令行界面（CLI）的开发者工具市场，让你可以直接从终端开通生产级服务（托管、数据库、身份验证、分析、AI 等）。OpenRouter 是首发合作伙伴，因此你只需一条命令即可为任何项目添加 AI 模型访问能力。完整目录见 projects.dev/providers，Stripe 文档见 docs.stripe.com/stripe-projects。

为什么将 Stripe 项目与 OpenRouter 一起使用？

• 一条命令即可开始。 stripe projects add openrouter/api 会开通 OpenRouter 账户、生成 API 密钥，并自动同步到你的 .env 文件。
• 统一账单。 通过同一个 Stripe 账户管理所有基础设施成本（托管、数据库、AI）。
• 凭据管理。 API 密钥存储在 Stripe 的加密保险库中，并同步到本地环境。轮换凭据无需改动代码库。
• 对智能体友好。 Stripe 项目会将技能文件写入项目目录，因此编程智能体可以代你开通和配置服务。

前提条件

1. 一个 Stripe 账户
2. 已安装并更新到最新的 Stripe CLI
3. 已安装 Projects 插件：

stripe plugin install projects

快速开始

浏览目录

列出所有服务提供商，或在安装前筛选到 OpenRouter：

# 所有服务提供商
stripe projects catalog

# 仅 OpenRouter 的服务和套餐
stripe projects catalog openrouter

你也可以在 Web 目录 projects.dev/providers 中浏览。

将 OpenRouter 添加到项目

如果你已经初始化了 Stripe 项目，一步即可添加 OpenRouter：

stripe projects add openrouter/api

这会开通一个 OpenRouter 账户（或关联你现有的账户），生成 API 密钥，并将 OpenRouter 的环境变量同步到 .env 文件。默认按 免费 套餐开通服务。升级请参见下方的 套餐与计费。

从零开始

如果要开始一个新项目，请先初始化：

# 初始化新的 Stripe 项目
stripe projects init my-app

# 添加 OpenRouter
stripe projects add openrouter/api

验证设置

添加 OpenRouter 后，确认一切正常：

# 检查项目状态
stripe projects status

# 测试 API 密钥
curl https://openrouter.ai/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -d '{
    "model": "~openai/gpt-mini-latest",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

会开通什么

运行 stripe projects add openrouter/api 时会发生以下事项：

1. 账户创建或关联。 Stripe 项目会按电子邮件查找你的 OpenRouter 账户，或自动创建新账户。各路径的详情见 账户关联。

2. 生成 API 密钥。 会铸造一把专用 API 密钥（sk-or-v1-...），并标记为 「由 Stripe 开通（Provisioned by Stripe）」，便于在 openrouter.ai/settings/keys 上与其他密钥区分。

3. 环境同步。 以下变量会存储在 Stripe 的加密保险库中，并写入项目的 .env：

   Copy

   OPENROUTER_API_KEY=sk-or-v1-...
   OPENROUTER_TYPE=bearer

你的 API 密钥可用于完整的 OpenRouter API，通过单一端点接入 400 多种 AI 模型。

服务详情

选择套餐

stripe projects add openrouter/api 会在开通时提示你在 免费 和 按量付费 套餐之间选择。免费套餐无需支付方式。之后要切换套餐，请使用 stripe projects upgrade 或 stripe projects downgrade：

# 将现有资源改为按量付费
stripe projects upgrade openrouter/api

# 改回免费套餐
stripe projects downgrade openrouter/api

管理你的 OpenRouter 服务

Stripe 的 remove 和 rotate 命令既接受本地资源名称（例如 openrouter-api），也接受 <provider>/<service> 引用。使用 stripe projects services list 查看项目中的确切资源名称。

轮换凭据

如果需要轮换 API 密钥（例如团队成员离职后）：

stripe projects rotate openrouter/api

这会生成新的 API 密钥，禁用旧密钥，并自动更新 .env 文件。

移除服务

要从项目中移除 OpenRouter 并撤销 API 密钥：

stripe projects remove openrouter/api

添加 --only-credentials 可仅忘记本地资源，而不在 OpenRouter 侧取消开通。

同步环境变量

列出项目的环境变量（值会被隐藏）：

stripe projects env

如果 .env 文件不同步，拉取最新凭据：

stripe projects env --pull

打开 OpenRouter 控制台

从 CLI 直接跳转到 OpenRouter 控制台：

stripe projects open openrouter

账户关联

Stripe 项目会按 Stripe 账户上的电子邮件解析你的 OpenRouter 账户：

• 没有现有 OpenRouter 账户。 会内联创建新账户，凭据直接从开通调用返回。无需弹出浏览器。
• 已有 OpenRouter 账户。 Stripe 和 OpenRouter 会完成无界面的 OAuth 2.0 授权码交换（针对 POST /api/v1/provisioning/oauth/token）以关联账户。常见情况下无需弹出浏览器。
• 回退。 在少数情况下（例如关联完成前的幂等重放），系统会提示你打开浏览器完成授权连接。一旦关联，该关联会在同一 Stripe 账户下的各个项目中保持。

套餐与计费

OpenRouter 通过 Stripe 项目提供两个套餐：

• 免费。 免费使用免费 AI 模型。无需支付方式。
• 按量付费。 400 多种模型按 Token 计费，无最低承诺。费率见 openrouter.ai/models。

选择付费套餐时，Stripe 会将存储在 Stripe 中的支付凭据令牌化为 共享支付令牌（Shared Payment Token），并向 OpenRouter 授予仅限该次升级使用的支付凭据。你的底层卡 / 银行详情绝不会被直接共享。

在 Stripe 侧管理支付方式：

# 查看已登记的支付方式
stripe projects billing show

# 添加或更新支付方式
stripe projects billing add

与编程智能体一起使用

Stripe 项目旨在与编程智能体配合使用。初始化项目时，Stripe 会将技能文件写入项目目录，以便智能体使用同一套确定性 CLI 开通和管理服务。

给你的智能体的示例提示词：

• 「把 OpenRouter 加到这个项目里，这样我就能调用 AI 模型。」
• 「轮换我的 OpenRouter API 密钥。」
• 「Stripe 项目目录里有哪些 AI 服务？」

stripe login
stripe projects link openrouter
stripe projects billing add   # 仅在计划使用按量付费时需要

对于完全非交互式开通（CI、脚本、智能体），请传入 --json --yes：

stripe projects add openrouter/api --json --yes

要为项目中的每个服务提供商（包括 OpenRouter 的快速开始、模型和 SDK 技能）给智能体一份合并的最新上下文文档，请运行：

stripe projects llm-context

后续步骤

• 快速开始。了解调用 OpenRouter API 的基础。
• 模型。浏览 400 多种可用模型并比较定价。
• API 密钥轮换。凭据管理的最佳实践。
• 护栏。设置消费限额和模型限制。
• 服务提供商选择。控制由哪些服务提供商处理你的请求。