SkillPay 接入实录:我用 HTTP 402 让 AI Skill 在对话里收钱

💡 原文中文,约3300字,阅读约需8分钟。
📝

内容提要

作者将三个心理咨询Skill接入SkillPay,按次收费1.99元,核心是基于HTTP 402的支付链路:无凭证请求返回402账单,用户扫码授权后带凭证重试,服务端验付、生成内容并确认履约。作者总结了四个问题:沙箱金额固定为0.01元、不能保留跳过验签的开关、推理模型的思维链占用输出预算、JSON偶发不合法需降低温度重试。三个Skill共用一套后端,通过lens字段区分场景;危机情况不走付费流程,直接转介专业机构。

🔎

延伸解读

从卖文件到卖服务:SkillPay 的交付逻辑

文章指出,普通 Skill 本质是可下载的源文件,一旦离开服务器就容易被复制和修改。SkillPay 将交付物变为作者控制的后端服务,SKILL.md 只是调用说明书。这种模式让知识产品的价值从可复制的文件转移到可调用的能力上,作者能持续控制服务端逻辑,避免被简单抄袭。

HTTP 402 支付链路的四个硬规则

文章详细描述了基于 HTTP 402 的支付流程:无凭证请求返回账单,用户扫码授权后带凭证重试,服务端验付并履约。同时列出四个硬规则:金额以服务端账单为准、pay_before 过期拒绝、trade_no 不可跨订单复用、履约只允许一次。这些规则写在官方文档和服务端校验中,确保支付安全。

接入中的四个实际坑与应对

作者总结了四个问题:沙箱金额固定为 0.01 元,与配置价格无关;不能保留跳过验签的开关,否则预检不通过;推理模型的思维链会占用 max_tokens 预算,导致内容为空;JSON 偶发不合法,需降低温度重试一次。这些坑反映了接入时需注意的细节,尤其是预算设置和重试机制的必要性。

一套后端支撑三个场景的设计与边界

三个心理咨询 Skill 共用一套后端,通过 lens 字段区分亲密关系、情绪、亲子场景,账单商品名按 lens 取,金额和资源 ID 共用。这种设计降低了运维成本,但 SQLite 单写者模型限制只能单实例运行。此外,危机情况不走付费流程,直接转介专业机构,体现了产品底线。

❓

Q&A

SkillPay 和普通可下载的 Skill 有什么本质区别?

普通 Skill 是可下载的源文件,谁拿到都能跑和改;SkillPay 卖的是你控制的后端服务,SKILL.md 只是调用说明书。文件会被抄走,服务不会。

HTTP 402 支付链路具体是怎么跑通的?

用户请求不带凭证,服务端返回 402 和 Base64URL 账单;用户扫码授权后,skill 带 Payment-Proof 重试原请求;服务端验付、生成内容、确认履约,最后返回 200。

接入 SkillPay 时作者踩了哪些坑?

四个坑:沙箱金额固定为 0.01 元,与配置价格无关;不能保留跳过验签的开关,预检会查;推理模型的思维链占用 max_tokens 导致内容为空;JSON 偶发不合法,需降温度重试一次。

三个心理咨询 Skill 是如何共用一套后端的?

三个场景记录结构和分析框架高度重合,所以只做一个服务端,请求体加可选字段 lens 区分场景;账单商品名按 lens 取,金额等共用,系统提示词按 lens 选文件,未知 lens 返回 400。

为什么心理咨询的危机情况不走付费流程?

作者把危机不走付费写死在流程里:出现自伤、自杀念头、暴力、虐待、涉及孩子的伤害信号,直接转介专业机构和热线,不推销分析,不做关系技巧建议。这是产品底线。

SkillPay 的免费能力和付费能力是怎么划分的?

免费部分包括记录和趋势:今天发生了什么、当时怎么反应、这周和上周比是往上还是往下;付费部分只有一次更深入的判断:定性状态、区分信号与解读、接下来该做什么、什么话不能说。

🏷️

标签

➡️

继续阅读