套餐设计

场景

系统运行稳定,用户持续增长。

Admin Dashboard

日调用量100 万次
写操作10 万次/天
读操作100 万次/天
读写比例1:10
注册用户3.0 千
日活用户800
日调用量60 万

最近调用记录

5 条
时间方法API 路径IP 地址状态码延迟
2026-08-03 11:40:18POST/api/v1/usage/report10.21.3.820082ms
2026-08-03 11:40:13GET/api/v1/weather?city=xian10.21.3.520027ms
2026-08-03 11:40:09GET/api/v1/weather?city=wuhan10.21.3.220030ms
2026-08-03 11:40:05POST/api/v1/billing_reconciliation/preview10.21.3.1420095ms
2026-08-03 11:40:00GET/api/v1/weather?city=tianjin10.21.3.1120029ms

但运营团队找到我:

Ops Chat
周三 14:10
运

当前问题:

  • 服务器成本:¥2000/月
  • 外部 API 成本:¥1000/月
  • 总成本:¥3000/月
  • 收入:¥0/月

我们需要尽快实现盈利!

商业化需求

运营团队提出了需求:

Ops Chat
周三 14:25
运

目标:

  1. 设计差异化套餐
  2. 吸引部分用户付费
  3. 覆盖服务器成本
  4. 最终实现盈利

用户分层:

  • 个人开发者:用量小,对价格敏感
  • 初创公司:用量中等,需要稳定性
  • 大型企业:用量大,需要专属服务

套餐设计

我调研了竞品的定价策略:

竞品分析

竞品 A 定价:
- 免费版:100 次/天
- 基础版:¥99/月,10000 次/天
- 专业版:¥499/月,100000 次/天
- 企业版:联系销售

竞品 B 定价:
- 免费版:1000 次/月
- 基础版:¥49/月,50000 次/月
- 专业版:¥199/月,500000 次/月
- 企业版:¥999/月,无限制

我的定价策略

基于成本分析和竞品调研,我设计了这样的套餐:

特性免费版基础版专业版企业版
价格¥0/月¥99/月¥499/月定制
每日限额1000 次10000 次100000 次无限制
每秒限额1 次/秒10 次/秒100 次/秒1000 次/秒
突发容量10 次100 次1000 次10000 次
API 数量3 个10 个所有所有
数据保留7 天30 天90 天永久
技术支持社区邮件邮件+IM专属经理
SLA 保证无99.5%99.9%99.95%
自定义域名❌❌✅✅

数据库设计

pricing_plansFields
字段名类型约束 / 说明
idINTPRIMARY KEY, AUTO_INCREMENT
nameVARCHAR(50)UNIQUE, free/basic/pro/enterprise
display_nameVARCHAR(100)套餐展示名
price_monthlyDECIMAL(10,2)月费
daily_limitINT每日配额
rate_limit_per_secondINT每秒限流
burst_capacityINT突发容量
max_apisINT可用 API 数量
data_retention_daysINT数据保留天数
support_typeVARCHAR(50)community/email/priority/dedicated
custom_domainBOOLEAN是否支持自定义域名
created_atTIMESTAMPDEFAULT CURRENT_TIMESTAMP
pricing_plansRows
idnameprice_monthlydaily_limitrate_limit_per_secondsupport_type
1free0.0010001community
2basic99.001000010email
3pro499.00100000100priority

套餐管理 API

套餐设计完只是第一步,真正把它变成产品的是这三个 API:用户能看到哪些套餐、自己现在是什么套餐、怎么升级或降级。它们的共同要求是幂等——同一个请求重复提交不能改两次账。

获取套餐列表

这个接口是定价页的数据来源,对所有用户开放。难点在可见性:免费用户不该看到企业版,而企业版的具体额度也不适合写死在代码里。

设计流程

获取套餐列表

  1. 步骤 1:从套餐配置表读出所有在售套餐的定价、限额和功能开关
  2. 步骤 2:按调用方身份过滤可见套餐,例如免费用户不展示企业版
  3. 步骤 3:把每个套餐的额度换算成统一的限额对象,供前端展示和限流中间件共用
  4. 步骤 4:缓存套餐列表并带上版本号,套餐配置发生变更时让缓存失效

关注点:套餐可见性、限额对象的统一口径与配置变更时的缓存失效。

获取用户当前套餐

用户最常问的一句话是「我现在是什么套餐、还剩多少额度」。这个接口要在一次查询里同时给出套餐身份、计费周期和周期内已用量,否则前端还得再调好几个接口。

设计流程

获取用户当前套餐

  1. 步骤 1:校验调用方的 API Key,并从中解析出对应的用户 ID
  2. 步骤 2:按用户 ID 读取订阅关系表,取出当前生效的套餐和本计费周期的起止时间
  3. 步骤 3:汇总周期内已用量一起返回,让用户随时知道自己还剩多少额度

关注点:订阅关系查询、计费周期边界与用量口径的一致性。

升级/降级套餐

这是整个计费链路里最容易出错的一步:钱付了但套餐没变,或者同一次操作被扣了两次款。所以顺序必须是先确认支付成功,再改订阅,最后异步刷新权益和限流。

设计流程

升级/降级套餐

  1. 步骤 1:校验目标套餐是否存在,算出差价以及是立即生效还是下个周期生效
  2. 步骤 2:校验支付状态与回调结果,确认支付成功之后才写入订阅关系
  3. 步骤 3:更新订阅记录里的套餐 ID、周期起止时间和待生效变更,保证一个用户只有一条有效订阅
  4. 步骤 4:把变更事件写入队列异步刷新限流阈值与权益,并向用户返回明确的生效时间

关注点:支付确认与订阅写入的先后顺序、幂等性与生效时间。

套餐对比页面

K

快易查

生活服务

天气查询 API

获取全球城市的实时天气信息,包括温度、湿度、天气状况等

GET/api/weather
金融服务

汇率转换 API

支持 150+ 种货币的实时汇率查询和转换

GET/api/exchange
网络工具

IP 地址查询 API

根据 IP 地址获取地理位置、运营商等信息

GET/api/ip
人工智能

文本分析 API

情感分析、关键词提取、文本分类等 NLP 功能

POST/api/text/analyze
网络工具

二维码生成 API

自定义样式生成二维码,支持 Logo 和颜色配置

POST/api/qrcode
生活服务

节假日查询 API

查询中国法定节假日、调休安排、工作日信息

GET/api/holiday

套餐对比

免费版

适合个人学习和测试

¥0/月
  • ✓ 1000 次/天
  • ✓ 1 次/秒
  • ✓ 突发容量 10 次
  • ✓ 3 个 API
  • ✓ 数据保留 7 天
  • ✓ 社区支持
  • × SLA 保证
  • × 自定义域名
基础版

适合小型项目和初创团队

¥99/月
  • ✓ 10000 次/天
  • ✓ 10 次/秒
  • ✓ 突发容量 100 次
  • ✓ 10 个 API
  • ✓ 数据保留 30 天
  • ✓ 邮件支持
  • ✓ 99.5% SLA
  • × 自定义域名
专业版

适合成长期企业和高并发场景

¥499/月
  • ✓ 100000 次/天
  • ✓ 100 次/秒
  • ✓ 突发容量 1000 次
  • ✓ 所有 API
  • ✓ 数据保留 90 天
  • ✓ 邮件 + IM 支持
  • ✓ 99.9% SLA
  • ✓ 自定义域名
企业版

适合大型企业和定制需求

定制
  • ✓ 无限制调用
  • ✓ 1000 次/秒
  • ✓ 突发容量 10000 次
  • ✓ 所有 API
  • ✓ 永久数据保留
  • ✓ 专属客户经理
  • ✓ 99.95% SLA
  • ✓ 定制服务

限流集成

套餐如果不能落到限流上,就只是写在页面上的一个数字。这一节要说明同一份套餐额度,如何变成限流中间件里可以直接使用的参数。

根据套餐设置限流

限流参数必须从套餐配置推导出来,而不是写死在代码里。这样运营调整套餐价格或额度时,限流行为跟着一起变,不需要改代码发版。

设计流程

根据套餐设置限流

  1. 步骤 1:读取用户当前套餐,把套餐里的每日、每秒和突发额度换算成限流参数
  2. 步骤 2:以用户 ID 加接口维度作为限流 key,在 Redis 中原子自增计数并设置窗口过期时间
  3. 步骤 3:超过额度时按策略返回排队等待或直接拒绝,并带上可重试的时间
  4. 步骤 4:升级后清掉旧的限流计数,降级后立即按新额度拦截,避免额度残留

关注点:套餐额度到限流参数的换算、计数 key 的维度与套餐变更后的计数清理。

当前架构

技术架构
客户端

用户请求

GET https://dashboard.kuaiyizhi.cn/api/v3/weather?city=北京
负载均衡层

Nginx 负载均衡

应用服务

Nginx

Python

Public API Gateway

Admin API

Static

Admin Dashboard


MySQL

Redis 缓存 + 限流

外部服务

MySQL 计费库

消息队列

外部天气 API

发现内容有问题?

告诉我们哪里需要改进。