用途 该技能面向把 API 调用转化为收入的完整链路,包括定价模型设计、配额执行、用量计量、账单生成与 Stripe 集成。
主要能力
- 定价模型:平固定月费、按用量付费、基础费加超量混合计费。
- 计量基础设施:位于网关与计费系统之间,要求持久、幂等、近实时;常见做法是消息队列加聚合服务再上报 Stripe。
- 开发者套餐:命名捆绑的配额、限流与功能开关,典型为免费、专业、企业三级,每级映射到 Stripe Price。
- 限流:在网关层用令牌桶或滑动窗口按 API Key 执行,返回 429 及 Retry-After、X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset 响应头。
- Stripe 计量:创建计量 Price、订阅客户、通过 stripe.subscriptionItems.createUsageRecord() 上报用量,Stripe 在计费周期末聚合开票。
使用方式 资料给出套餐 YAML 示例、Stripe 产品与计量价创建、订阅与用量上报、基于 Redis 滑动窗口的 Express 限流中间件、按小时刷新的用量缓冲上报、80%/100%/120% 阈值超额通知等代码片段。
适用场景 公开或合作 API 的定价设计、按调用量计费、按付费等级限流、Stripe 计量集成、开发者分级门户、超量计费与配额限流处理。
限制与注意事项
- 禁止在无法准确计量时收费;不要仅依赖网关日志计费。
- 用量上报必须用 action: 'increment',否则重试会覆盖总量导致少计费。
- 内存缓冲在进程重启时丢失,生产应使用持久队列(SQS、Kafka、带 AOF 的 Redis)。
- Redis 有序集合滑动窗口的检查与自增非原子,高并发下需用 Lua 脚本或多事务保证原子性。
- Stripe 计量价格的 aggregate_usage 创建后不可更改,需提前规划聚合模型。
- 免费层也需设硬性限流与滥用检测。
- 配额耗尽宜限流或超量计费,避免硬切断。
- 实时逐请求上报会造成 Stripe API 压力,应按小时或天批量上报。
- 参考文件 references/stripe-metering.md 与 references/rate-limiting-patterns.md 仅在任务需要时加载。
- 首次激活时可按说明运行 ls ~/.claude/skills/ 等命令检查配套技能,缺失时可用 npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name> 安装;无配套技能时跳过。 以上代码与命令均按原文保留。