OpenRouter.help
返回首页

stripe-projects

阅读约 11 分钟

原文链接：Stripe Projects

Stripe Projects

使用 Stripe Projects CLI 将 OpenRouter 添加到您的应用

Stripe Projects 是一个基于 CLI 的开发者工具市场，让您可以直接从终端配置生产级服务 — 托管、数据库、身份验证、分析、AI 等。OpenRouter 是 launch partner，因此您可以使用单个命令将 AI 模型访问添加到任何项目。在 projects.dev/providers 浏览完整目录，在 docs.stripe.com/stripe-projects 阅读 Stripe 文档。

为什么使用 Stripe Projects 和 OpenRouter？

一条命令即可开始 — stripe projects add openrouter/api 配置 OpenRouter 账户、生成 API key 并自动同步到您的 .env 文件。

统一账单 — 通过单个 Stripe 账户管理所有基础设施成本（托管、数据库、AI）。

凭证管理 — API key 存储在 Stripe 的加密保险库中并同步到本地环境。轮换凭证而无需接触代码库。

Agent 友好 — Stripe Projects 将 skill 文件写入项目目录，因此编码 Agent 可以代表您配置和管理服务。

前置要求

  • Stripe 账户
  • 安装并保持最新的 Stripe CLI
  • 安装 Projects 插件：
stripe plugin install projects

快速开始

浏览目录

列出每个提供商或筛选到 OpenRouter 后再安装：

# 所有提供商
stripe projects catalog

# 仅 OpenRouter 的服务和计划
stripe projects catalog openrouter

您还可以在 projects.dev/providers 浏览网页目录。

将 OpenRouter 添加到您的项目

如果您已有 Stripe 项目初始化，一步添加 OpenRouter：

stripe projects add openrouter/api

这将配置 OpenRouter 账户（或链接您现有的账户）、生成 API key 并将 OpenRouter 的环境变量同步到您的 .env 文件。默认情况下，服务使用 Free 计划配置 — 请参阅下面的 Plans and billing 升级。

从头开始

如果您要开始一个新项目，首先初始化它：

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

# 添加 OpenRouter
stripe projects add openrouter/api

验证设置

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

# 检查项目状态
stripe projects status

# 测试 API key
curl https://openrouter.ai/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -d '{
    "model": "openai/gpt-4.1-mini",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

配置了什么

当您运行 stripe projects add openrouter/api 时，会发生以下情况：

账户创建或链接 — Stripe Projects 通过电子邮件找到您的 OpenRouter 账户或自动创建一个新账户。请参阅下面的 Account linking 了解每个路径的详情。

API key 生成 — 生成专用 API key（sk-or-v1-...）并标记为 "Provisioned by Stripe"，便于在 openrouter.ai/settings/keys 上与其他 key 一起识别。

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

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

您的 API key 可与完整的 OpenRouter API 配合使用，让您通过单个端点访问 300+ AI 模型。

服务详情

项目详情
ProviderOpenRouter
Serviceopenrouter/api
CategoryAI
Plans免费（无需信用卡）或按量付费（按 token 使用量计费）
Pricing按 token 计费，因模型而异。请参阅模型定价。

选择计划

stripe projects add openrouter/api 在配置时会提示您在 Free 和 Pay-as-you-go 计划之间选择。Free 计划无需支付方式即可使用。要稍后切换计划，请使用 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 key（例如团队成员离开后）：

stripe projects rotate openrouter/api

这将生成新的 API key、禁用旧的 key 并自动更新您的 .env 文件。

移除服务

从项目中移除 OpenRouter 并撤销 API key：

stripe projects remove openrouter/api

添加 --only-credentials 可忘记本地资源而不取消 OpenRouter 端的配置。

同步环境变量

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

stripe projects env

如果您的 .env 文件不同步，请拉取最新凭证：

stripe projects env --pull

打开 OpenRouter 仪表板

直接从 CLI 跳转到您的 OpenRouter 仪表板：

stripe projects open openrouter

账户链接

Stripe Projects 通过 Stripe 账户上的电子邮件解析您的 OpenRouter 账户：

没有现有 OpenRouter 账户 — 创建一个新账户，内联返回凭证。不需要浏览器弹出窗口。

有现有 OpenRouter 账户 — Stripe 和 OpenRouter 完成无头 OAuth 2.0 代码交换（针对 POST /api/v1/provisioning/oauth/token）以链接您的账户。在常见情况下不需要浏览器弹出窗口。

回退 — 在极少数情况下（例如，在链接完成前的幂等重放），系统会提示您打开浏览器以完成授权。一旦链接，关联将跨同一 Stripe 账户中的项目持久化。

计划与计费

OpenRouter 通过 Stripe Projects 提供两个计划：

Free — 零成本访问免费 AI 模型。无需支付方式。

Pay-as-you-go — 跨 300+ 模型的按 token 计费，无最低承诺。请参阅 openrouter.ai/models 了解费率。

当您选择付费计划时，Stripe 将您的 Stripe 存储的支付凭证令牌化为 Shared Payment Token，并向 OpenRouter 授予仅限于该升级的支付凭证。您的底层卡/银行详细信息永远不会直接共享。

在 Stripe 端管理您的支付方式：

# 查看存档的支付方式
stripe projects billing show

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

与编码 Agent 配合使用

Stripe Projects 旨在与编码 Agent 配合工作。当您初始化项目时，Stripe 将 skill 文件写入项目目录，以便 Agent 可以使用相同的确定性 CLI 配置和管理服务。

Agent 的示例提示：

  • "将 OpenRouter 添加到这个项目，以便我可以调用 AI 模型。"
  • "轮换我的 OpenRouter API key。"
  • "Stripe Projects 目录中有哪些 AI 服务可用？"

为避免 Agent 驱动的配置期间出现浏览器弹出窗口，请在启动 Agent 会话之前手动完成以下流程：

stripe login
stripe projects link openrouter
stripe projects billing add   # 仅当您计划使用按量付费时

然后让 Agent 调用 stripe projects add openrouter/api。

对于完全非交互式配置（CI、脚本、Agent），请传递 --json --yes：

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

要给您 Agent 一个包含项目中每个提供商的组合、最新的上下文文档（包括 OpenRouter 的 quickstart、models 和 SDK 技能），请运行：

stripe projects llm-context

下一步

© 2026 OpenRouter.help
查看官方英文原件