以下三家公司与全部数字均为教学假设,用于演示商业化计算,不代表任何真实企业。
API 优先首先是一种分发方式
「API 优先」经常被理解成产品形态:先有 API,再有界面。这只说对了一半。对商业化来说,API 优先首先是一种分发方式:客户不需要先见销售,自己注册、读文档、拿到密钥、跑通第一次调用,然后按用量付费。产品本身就是渠道,文档就是售前,定价页就是报价单。
这个定义听起来很轻,但它把渠道成本的结构彻底改了。传统企业销售里,一笔单子要经过线索筛选、演示、方案、报价、法务、采购,每一步都有人工工时;API 优先把前几步压缩成一次自助注册,把人工留到用量上来之后。省下来的不是产品钱,是销售流程钱。
Verba 的渠道结构很能说明问题。它常被当成典型的 API 公司,但直销只占 50%,平台市场占 35%,生态伙伴占 15%。API 优先并不等于只靠官网卖,它改变的是「谁来完成第一次价值验证」,不改变「收入最终从哪些通道进来」。
开发者先评估,预算方后签字
API 产品的购买通常分两步。第一步是开发者评估:能不能装、文档是否可读、第一次调用是否成功、失败时错误码是否说得清。第二步才是预算方签字:这个东西每月要花多少钱、能不能报销、出了故障谁负责。
API 优先的优势在第一步。开发者不需要等采购流程,几分钟内就能判断产品是否可用;如果可用,他会把它带进项目,用量自然发生。劣势在第二步:开发者喜欢不等于公司会付钱,预算方关心的是账单上限、合规与责任,而不是 SDK 写得好不好。
所以 API 优先的公司不能只有自助注册。Verba 的 26 个企业客户贡献了 18% 的收入,企业单笔 CAC 是 6,000 美元,而自服务 CAC 只有 420 美元,两者相差 14.29 倍。这个差距说明:自助渠道负责把开发者带进来,企业销售负责把账户变成合同。两条腿缺一条,收入结构就会偏。
把渠道结构摊开:50% 直销、35% 平台、15% 伙伴
Verba 的月收入是 336,000 美元。按渠道拆开,直销 50% 是 168,000 美元;平台市场 35% 是 117,600 美元;生态伙伴 15% 是 50,400 美元。后两者合计 168,000 美元,是经过中间商的收入。
平台市场的分成比例是 20%,生态伙伴是 15%,渠道支持成本统一按渠道内收入的 4% 计。于是:
分成 = 117,600 × 20% + 50,400 × 15%
= 23,520 + 7,560
= 31,080
支持成本 = 168,000 × 4% = 6,720
渠道净收入 = 336,000 − 31,080 − 6,720 = 298,200
渠道净收入率 = 298,200 ÷ 336,000 = 88.8%
这组数回答了一个常见误会:API 优先不等于没有渠道成本。即使客户是自己找上门的,只要他通过平台市场或伙伴的集成进来,收入就要先扣一层。88.8% 的净收入率意味着每 1 美元毛收入最后只有 0.888 美元可用,剩下的 0.112 美元是渠道的过路费。
自服务的单位经济:231.72 美元与 3.8 个月
Verba 有 1,450 个付费账户,月收入 336,000 美元。ARPA 是:
ARPA = 336,000 ÷ 1,450 = 231.72 美元
毛利率是 47.5%,所以每个账户每月贡献的毛利是 231.72 × 47.5% = 110.07 美元。自服务 CAC 是 420 美元,回本周期是:
回本周期 = 420 ÷ 110.07 = 3.8 个月
LTV 用同一套口径算是 231.72 × 0.475 ÷ 0.021 = 5,240 美元。LTV 是 CAC 的 12.5 倍,单看这个比值,API 渠道的单位经济是健康的。
但健康不等于稳定。Verba 的月流失率是 2.1%,是三个案例里最高的:LumenDesk 是 0.8%,ClausePilot 是 0.6%。按 1,450 个付费账户算,每月要补 1,450 × 2.1% ≈ 30 个新付费账户,才能把账户数维持在原地。自服务渠道的 CAC 低,代价是账户来得快、走得也快。
API 渠道的四个激活指标
自服务渠道的转化不是一个数字,而是一条链。链上每一环都有指标,任何一环断开,后面的收入都不会发生。
首次调用时间。 从注册到第一次成功返回的时间。这个指标衡量文档与 onboarding 的质量,通常以分钟或小时计。时间越长,开发者在遇到困难之前放弃的概率越高。优化手段是缩短密钥获取路径、提供可复制的最小示例、把常见错误写进第一屏。
首周调用量。 注册后七天的总调用量。它区分「试了一下」和「接入了工作流」。首周调用量低的账户,即使后来付费,用量也很难增长。这个指标比注册数更能预测付费。
三十天留存。 注册后三十天仍在调用的账户比例。API 产品的留存曲线通常在前两周陡降,之后趋稳。如果三十天留存低,说明产品没有进入开发者的日常流程,免费额度只是在延长死亡时间。
付费转化。 从免费账户到第一个付费账单的比例,必须按 cohort 算。它回答的是「免费层是否筛出了愿意付钱的人」,而不是「有多少账户存在」。
四个指标的顺序不能颠倒。先有首次调用,才有首周用量;先有三十天留存,付费转化才有意义。很多团队只盯付费转化,忽略了前面的漏斗,结果把预算花在一批永远不会激活的账户上。
四个指标也要一起看,不能单独优化。只缩短首次调用时间,会让一批不适合的账户快速进入;只提高首周调用量,可能鼓励刷量;只看三十天留存,会忽略留存下来的账户是否付费。激活是一个组合指标,任何单点优化都可能把问题推到下一环。
代码:把 API 渠道算成四个数
// file: src/scale/03-1-api-first.ts
// tier: L1
// verify: node --test test/scale/03-1-api-first.test.ts
// API 优先的分发:自服务账户的 ARPA、回本与免费层占比。
import { type Cents } from "../core/money.ts";
import { FULL, type Bps } from "../core/rate.ts";
export type ApiBusiness = {
paidAccounts: number;
freeAccounts: number;
monthlyRevenueCents: Cents;
grossMarginBps: Bps;
cacCents: Cents;
};
/** ARPA = 月度收入 ÷ 付费账户数,单位美分。 */
export function arpaCents(b: ApiBusiness): Cents {
if (b.paidAccounts === 0) return 0;
return Math.round(b.monthlyRevenueCents / b.paidAccounts);
}
/** 回本周期 = CAC ÷ (ARPA × 毛利率),单位月,保留两位小数。 */
export function paybackMonths(b: ApiBusiness): number {
const monthlyMargin = (arpaCents(b) * b.grossMarginBps) / FULL;
if (monthlyMargin === 0) return 0;
return Math.round((b.cacCents / monthlyMargin) * 100) / 100;
}
/** 付费账户占全部账户的比例,单位基点。 */
export function paidAccountShareBps(b: ApiBusiness): Bps {
const total = b.paidAccounts + b.freeAccounts;
if (total === 0) return 0;
return Math.round((b.paidAccounts / total) * FULL);
}
/** 企业 CAC 是自服务 CAC 的多少倍。 */
export function enterpriseCacMultiple(
selfServeCacCents: Cents,
enterpriseCacCents: Cents,
): number {
if (selfServeCacCents === 0) return 0;
return Math.round((enterpriseCacCents / selfServeCacCents) * 100) / 100;
}
export const VERBA_API: ApiBusiness = {
paidAccounts: 1_450,
freeAccounts: 8_000,
monthlyRevenueCents: 33_600_000,
grossMarginBps: 4_750,
cacCents: 42_000,
};
四个输出分别对应四个判断:ARPA 是 23,172 美分,也就是 231.72 美元;回本是 3.82 个月;付费账户占全部账户 1,534 个基点,即 15.3%;企业 CAC 是自服务 CAC 的 14.29 倍。前两个数说明这条渠道能赚钱,后两个数说明它并不覆盖全部客户。
免费账户不是渠道收入,是渠道成本
Verba 还有 8,000 个免费账户。免费额度是每月 60 分钟,实际平均用量是 42 分钟,单分钟变动成本是 0.0042 美元。免费层的月度成本是:
8,000 × 42 × 0.0042 = 1,411.20 美元
这笔钱占 336,000 美元月收入的 0.4%。单看比例很小,但它是真实现金支出,必须放在成本预算里,而不是塞进市场费用。免费账户的付费转化也不会自动发生:1,450 个付费账户加 8,000 个免费账户,付费账户占全部账户的 15.3%。这个 15.3% 是账户结构,不是转化率;真正的转化率要按注册月份分 cohort 算,不能拿总量相除。
免费层最危险的地方不是平均成本,而是尾部。如果某个账户把 60 分钟跑满,成本是 60 × 0.0042 = 0.252 美元;8,000 个账户全部跑满,月成本是 2,016 美元,占收入 0.6%。平均 0.4% 与最坏 0.6% 之间只差 0.2 个百分点,说明 Verba 的免费额度设计相对克制。换成额度更大、单价更高的产品,这个差距会迅速放大。
用量波动:API 渠道的结构性风险
API 渠道的收入跟随客户调用量,而调用量跟随客户的业务量。客户业务下滑,用量先降;客户迁移到别家,收入直接归零。这种波动不会在月度总收入上立刻显形,却会在流失率与 NRR 上留下痕迹。
Verba 的 NRR 是 106%,低于 LumenDesk 的 112% 和 ClausePilot 的 118%。106% 意味着现有客户的扩张只比降级与流失多 6 个百分点,几乎没有缓冲。一旦某个大客户减量,NRR 会很快掉到 100% 以下。前 10 大客户占收入 28%,集中度不算极端,但足以让一个客户的迁移影响整月预测。
这不是说 API 渠道不好,而是说它的经营节奏不同。订阅制可以靠合同锁定一年,API 渠道只能靠持续的产品价值和切换成本留住客户。API 公司真正需要监控的不是 MRR 总额,而是「用量下降超过 30% 的账户数」和「连续两个月未调用但未注销的账户数」。这两个数比流失率更早发出信号。
文档、限额与状态页:API 渠道的三件基础设施
API 优先的公司,渠道能力主要不在销售团队,而在三件基础设施上。
文档。 文档的目标不是「写全」,而是让开发者在最短时间内跑通一次成功调用。第一个可运行示例、密钥获取路径、错误码含义、常见失败的排查顺序,这四件事决定激活率。文档写得再长,如果示例跑不起来,渠道就断在第一步。
限额。 限额既是成本控制,也是产品契约。每分钟多少请求、并发多少、超限返回什么状态码、多久后重试,必须在文档里写死。限额不透明,开发者会用重试把故障放大;限额写清楚,开发者会自己设计退避。限额还是免费层与付费层的分界线,下一节会展开。
状态页。 API 渠道没有销售面对面解释故障,状态页就是信任基础设施。故障开始时间、影响范围、当前进展、历史可用性,都要能被客户独立查到。状态页不是公关页,它是事故期间减少支持工单的工具。
三件基础设施的共同点是:它们都是一次性投入、长期复用,边际成本接近零。这正是 API 渠道能把 CAC 压到 420 美元的原因。反过来,任何一件缺失,省下的销售成本都会以支持工单和流失的形式还回来。
这三件基础设施还要能版本化。文档随 API 版本更新,限额随套餐调整,状态页保留历史故障记录;任何一处只保留最新版本,开发者在升级或排查时就失去了参照。版本化本身就是渠道可信度的一部分。
定价页就是渠道页
自助购买的客户不会听销售解释定价,他只会看定价页,然后拿计算器算。Verba 的单价是每分钟 0.008 美元,其中转写 0.006 美元、说话人分离 0.002 美元。按小时算就是 0.48 美元,这个数比「每分钟 0.008 美元」更容易被预算方理解。
定价页要回答三个问题:用多少、花多少、超了怎么办。用多少,要给典型场景的用量估算;花多少,要给阶梯价或承诺量折扣;超了怎么办,要说明是降速、停机还是按超额单价继续。三个问题里任何一个含糊,开发者就会去竞品页面找答案。
API 定价最忌讳的是「联系销售」。对自助客户来说,这句话等于「你不配知道价格」。如果产品确实需要企业报价,就把自助价和企业价分开写:自助价公开,企业价说明起售量与包含项。透明不会拉低价格,只会减少比价时的摩擦。
从自服务到企业销售的交接
Verba 的 26 个企业客户贡献 18% 的收入,企业单笔 CAC 是 6,000 美元,自服务 CAC 是 420 美元。这两个数不是互相替代的关系,而是同一条漏斗的两段:自服务负责让开发者用起来,企业销售负责让公司签合同。
交接点通常由三个信号触发。第一,用量超过某个阈值,比如某个账户的月调用量进入前 5%,说明它已经在生产环境使用。第二,客户提出合规、数据驻留、责任条款或发票要求,说明采购流程已经启动。第三,客户要求多席位、多项目或年度合同,说明它不再是个人开发者。
交接的关键不是把账户转给销售,而是把上下文转给销售。开发者已经跑过的用例、用到的功能、遇到的限制、比较过的竞品,都要随账户一起交过去。没有上下文的交接,销售会从零开始问一遍,客户会觉得「你们不是一家的吗」。
交接还要防止反向伤害。如果销售一接触就要求升级套餐,开发者会觉得自助渠道是诱饵,下次评估新产品时会直接跳过。健康的交接是「销售帮你解决自助解决不了的问题」,而不是「销售来收钱」。
收入确认与用量对账
API 渠道的收入确认比订阅复杂。订阅在月初确认 MRR,API 要等用量发生、计量完成、账单生成,收入才能确认。这个时间差会影响现金流预测,也会影响销售提成的结算。
Verba 的月用量是 42,000,000 分钟,按月结算。如果计量系统延迟一天,月底的账单就要推迟一天,财务关账就要多等一天。对上市公司,这个延迟会影响季度确认;对创业公司,它会影响创始人对自己跑了多快的判断。
用量对账要回答三个问题:计量事件是否完整、重试是否重复计费、退款是否从收入里扣除。三个问题里任何一个出错,ARPA 与毛利率都会失真。比如把重试算进用量,收入会虚高,毛利率看起来更好;把退款漏掉,收入也会虚高,但现金没有进来。
所以 API 渠道的财务系统必须和计量系统对齐。计量事件带唯一 ID,账单按 ID 去重,退款走单独的贷项流程。对账不是财务的月底工作,而是产品的一部分:客户能在后台看到自己的用量明细,争议就会少很多。
对账频率也要匹配用量规模。月用量 42,000,000 分钟的账户,按天逐笔对账的成本很高;按月对账更现实。但对账周期越长,错误发现得越晚,退款与争议的处理成本越高。折中方案是系统内实时计量、财务按月对账、异常事件触发即时告警,比如单日用量超过月均值的 3 倍。
什么时候不该 API 优先
API 优先适合三类产品:价值可标准化、用量可计量、失败可重试。语音转写、文本生成、图像识别都属于这一类,客户能自己判断输出好不好,也能自己算用量。
ClausePilot 是反例。它 85% 的收入来自直销,只有 15% 走转售伙伴。合同审查的每一次输出都可能带来法律责任,客户不会因为 API 文档写得好就自助签约;它需要人工复核、责任条款、行业资质与采购流程。这类产品可以把 API 作为交付方式,但不能把 API 作为获客方式。
LumenDesk 在两者之间:60% 直销、40% 渠道分销。它的客户是中小 SaaS 公司,决策链比 ClausePilot 短,但仍需要演示与迁移支持,所以渠道分销承担了触达长尾的角色。
判断标准不是「产品有没有 API」,而是「客户能不能在没有人的情况下完成第一次价值验证,并愿意为结果付钱」。能,就做 API 优先;不能,就把 API 当成交付接口,另建销售渠道。
这三类判断可以做成一张简单的评分表:价值标准化、用量可计量、失败可重试各占一分,再加上客户是否需要人工复核与责任条款。分数只用于内部讨论,不用于对外宣传;它的作用是把「我们适不适合 API 优先」从直觉变成可争论的假设,而不是一次拍板。
这张表不解决争议,但它把争议限定在具体的分数上。团队可以先争论「失败可重试」这一项给 0 分还是 1 分,而不是笼统地争论「我们要不要做 API」。具体分歧比抽象立场更容易收敛。
小结
- API 优先是一种分发方式:文档、定价页与自助注册替代了销售流程的前几步。
- Verba 的渠道结构是 50% 直销、35% 平台、15% 伙伴,API 优先不等于只靠官网。
- 渠道净收入 = 336,000 − 31,080 − 6,720 = 298,200 美元,净收入率 88.8%。
- ARPA 231.72 美元、CAC 420 美元、回本 3.8 个月,自服务单位经济成立。
- 月流失 2.1% 意味着每月要补约 30 个付费账户才能维持账户数,低 CAC 伴随高流失。
- 免费层月成本 1,411.20 美元,占收入 0.4%;按跑满额度算是 2,016 美元,占 0.6%。
- 文档、限额、状态页是 API 渠道的基础设施,缺一件都会把省下的销售成本还回去。
- API 优先适合价值标准化、用量可计量、失败可重试的产品;高责任场景仍需直销。
阅读导航:上一节:2.3 分成后的单位经济 · 下一节:3.2 开发者定价与免费额度 。
常见错误与边界
- 把 API 优先理解成「只做 API」,忽略平台市场与生态伙伴仍然要收 20% 与 15% 的分成。
- 用总账户数相除得出「转化率」,把账户结构当成 cohort 转化,掩盖真实的激活与留存。
- 只报每分钟单价,不换算成每小时或每月账单,预算方无法判断实际支出。
- 免费额度按额度上限做预算,而不是按实际用量做预算,导致成本被高估或低估。
- 用低 CAC 掩盖高流失,不补新账户就假设收入会自然维持。
- 把高责任、强合规的产品硬做成自助注册,跳过人工复核与责任条款。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。