爆款选题与分类创作套件（付费 Skill）
按次计费的 AI 短视频创作门户模板交付服务。调用方（AI 智能体）首次请求会收到 HTTP 402 与 Payment-Needed 账单，完成支付后携带 Payment-Proof 重试即可获得交付结果。
交付内容
| 档位 | 价格 | resource_id | 交付物 |
|---|---|---|---|
standard |
¥5.00 | viral-topic-kit/deliver |
完整模板包：分类根页面 CategoryView.vue.txt、爆款选题页 PopularTopicsView.vue.txt + 选题数据 topics-data.ts（Vue 3 <script setup> + TypeScript），附合规风险扫描脚本 check_compliance.py 与接入文档 |
> 说明：因平台文件类型限制，两个 Vue 页面模板以 .vue.txt 后缀交付，内容与原 .vue 完全一致，下载后去掉 .txt 后缀即可直接使用。
接口
- 地址：
POST {BASE}/v1/kit/deliver - 探活/询价（免费）：
GET {BASE}/v1/kit/probe - Content-Type：
application/json
出参（HTTP 200）
| 字段 | 类型 | 说明 |
|---|---|---|
resource_id |
string | 资源标识，与账单一致 |
kit |
string | 技能标识 viral-topic-kit |
version |
string | 交付包版本 |
files[] |
array | 交付文件，{path, content} |
trade_no |
string | 支付宝交易号 |
out_trade_no |
string | 商户订单号 |
already_fulfilled |
boolean | true 表示命中幂等，返回的是已保存结果（不重复交付） |
fulfillment_confirmed |
boolean | 履约回执（ack）是否已确认 |
响应头 Payment-Validation（Base64URL JSON）含 validated / trade_no / out_trade_no / resource_id，用于校验交付归属。
未支付响应（HTTP 402）
响应头 Payment-Needed 为 Base64URL 编码的账单 JSON：
{
"protocol": {
"out_trade_no": "KIT_1730000000000_abcd1234",
"amount": "5.00",
"currency": "CNY",
"resource_id": "viral-topic-kit/deliver",
"pay_before": "2026-10-10T21:00:00+08:00",
"seller_signature": "...",
"seller_sign_type": "RSA2",
"seller_unique_id": "2088xxxxxxxx"
},
"method": {
"seller_name": "个人开发者 · 爆款选题与分类创作套件",
"seller_id": "2088xxxxxxxx",
"seller_app_id": "2021xxxxxxxx",
"goods_name": "爆款选题与分类创作套件 · 交付包",
"seller_unique_id_key": "seller_id",
"service_id": "<serviceId>"
}
}
调用流程
- 不带
Payment-Proof请求 → 收到402+Payment-Needed（402 账单下发）。 - 把账单交给支付宝 AI 付能力，用户在支付宝确认付款。
- 支付成功后携带
Payment-Proof请求头重试同一地址，原请求参数保持一致（凭证重试）。 - 服务端验付：校验凭证与订单、金额、有效期；无效或过期时不交付资源，重新出账（服务端验付）。
- 验付通过 → 生成交付物 → 发送履约确认 ack（失败自动重试，商家履约）→ 返回
200与交付内容。
同一 Payment-Proof 重复请求是安全的：命中幂等返回 already_fulfilled=true 与首次交付结果，不重复扣费、不重复交付（订单状态 SQLite 持久化，可恢复）。
错误处理
| HTTP | code | 处理建议 |
|---|---|---|
| 400 | INVALID_REQUEST |
修正请求体 JSON 后重试 |
| 402 | Payment-Needed |
按账单重新发起支付；凭证无效/过期时响应头附新账单 |
| 404 | NOT_FOUND |
检查端点路径 |
| 500 | INTERNAL_ERROR |
稍后重试；订单状态可恢复，不会重复扣费 |
部署
服务端实现见技能作者提供的部署仓库。服务端必须实现上述 402 协议全部环节（账单签发、凭证验付、履约 ack、订单幂等），并满足：
- 公网 HTTPS 可达（402/验付/履约必须在服务端完成）
- 持有 SkillPay 分配的
serviceId、卖家 RSA2 私钥、seller_id、seller_app_id生产配置 - 订单持久化（不重复扣费、不重复交付），交付结果可恢复
模板使用
支付交付后，按 references/ 中文档接入：category-page.md（分类页结构与额度门禁）、topics-page.md（选题页数据模型与跨平台适配）、api-contract.md（后端接口契约）、compliance.md（合规风险词表）。交付前运行 python scripts/check_compliance.py <目录> 做合规自检。
