Skip to content

Stripe Projects 是一个基于 CLI 的开发者工具市场,OpenRouter 是其首批合作 provider。只需运行 stripe projects add openrouter/api,即可自动完成 OpenRouter 账户创建/关联、API Key 生成和 .env 写入,无需任何手动操作。支持 Free(免费)和 Pay-as-you-go(按 token 计费)两种方案,密钥存储在 Stripe 加密金库中,可通过 stripe projects rotate 一条命令轮换。支持 AI 编程 Agent 的无人值守部署模式(--json --yes)。

Stripe Projects 是 Stripe 推出的 CLI 开发者工具市场,支持从终端直接 provision 托管、数据库、AI 等各类服务。OpenRouter 作为首批合作方,可通过一条命令接入。

为什么选择 Stripe Projects 接入 OpenRouter

  • 一条命令搞定stripe projects add openrouter/api 自动完成账户创建/关联、API Key 生成和 .env 写入
  • 统一账单 — 所有基础设施费用通过 Stripe 账户统一管理
  • 密钥管理 — API Key 存储在 Stripe 加密金库,密钥轮换无需修改代码
  • Agent 友好 — Stripe Projects 会在项目目录写入 skill 文件,AI 编程 Agent 可自主完成服务 provision

前置条件

  1. Stripe 账户
  2. 安装并更新到最新版 Stripe CLI
  3. 安装 Projects 插件:
bash
stripe plugin install projects

快速开始

浏览目录

bash
# 查看所有 provider
stripe projects catalog

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

添加 OpenRouter

如果项目已初始化,直接添加:

bash
stripe projects add openrouter/api

这条命令会自动完成:创建或关联 OpenRouter 账户、生成 API Key、将环境变量写入 .env。默认使用 Free 套餐,无需信用卡。

从零开始

bash
stripe projects init my-app
stripe projects add openrouter/api

验证接入

bash
# 查看项目状态
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 时:

  1. 账户创建或关联 — 通过邮箱匹配 OpenRouter 账户;无账户则自动创建,有账户则通过无界面 OAuth 2.0 关联
  2. API Key 生成 — 生成专属 API Key(sk-or-v1-...),标记为"Provisioned by Stripe"
  3. 环境变量同步 — 写入 .env
    OPENROUTER_API_KEY=sk-or-v1-...
    OPENROUTER_TYPE=bearer

套餐选择

套餐说明
Free使用免费模型,无需信用卡
Pay-as-you-go按 token 计费,覆盖 300+ 模型,无最低消费

切换套餐:

bash
stripe projects upgrade openrouter/api    # 升级到按量付费
stripe projects downgrade openrouter/api  # 降级回免费套餐

管理 OpenRouter 服务

轮换密钥

bash
stripe projects rotate openrouter/api

自动生成新 Key、停用旧 Key、更新 .env

移除服务

bash
stripe projects remove openrouter/api

--only-credentials 只删本地记录,不撤销 OpenRouter 侧的 API Key。

同步环境变量

bash
stripe projects env          # 查看变量列表(值隐藏)
stripe projects env --pull   # 从金库拉取最新值覆盖本地

打开 OpenRouter 控制台

bash
stripe projects open openrouter

账户关联流程

Stripe Projects 通过 Stripe 账户上的邮箱匹配 OpenRouter 账户:

  • 无 OpenRouter 账户 — 自动创建,直接返回凭证,无需浏览器弹窗
  • 已有 OpenRouter 账户 — 无界面 OAuth 2.0 静默关联,无需浏览器弹窗
  • 极端情况 — 少数情况下需要浏览器完成授权,关联后跨项目永久有效

付款方式

Pay-as-you-go 套餐通过 Stripe Shared Payment Token 授权——卡号不会直接传给 OpenRouter。

bash
stripe projects billing show   # 查看当前付款方式
stripe projects billing add    # 添加或更新付款方式

配合 AI 编程 Agent 使用

在启动 Agent 前,先手动完成一次性授权:

bash
stripe login
stripe projects link openrouter
stripe projects billing add  # 如果要用按量付费

然后让 Agent 执行 stripe projects add openrouter/api

非交互式 / CI / 脚本场景:

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

让 Agent 获取所有 provider 的最新上下文文档:

bash
stripe projects llm-context

常见问题

Q: Stripe Projects 接入和直接注册 OpenRouter 有什么区别?

A: 功能上完全等价——同一套 API、同一套模型、同一套定价。区别在于:Stripe Projects 把密钥管理、账单和环境变量同步都集成进了你已有的 Stripe 工作流,特别适合已经用 Stripe 管理其他服务的团队或需要 Agent 自动化 provision 的场景。

Q: 使用 Stripe Projects 接入会额外收费吗?

A: 不会。OpenRouter 的定价和直接接入完全一样,按所用模型的 token 价格计费。

Q: API Key 在哪里管理?

A: Key 在 Stripe 加密金库中存储,同时也出现在 OpenRouter 的 密钥设置页(标注为"Provisioned by Stripe")。两边都可以查看,通过 stripe projects rotate 轮换时两边同步更新。