黄金3秒口播脚本生成器（Pay Skill）

专治「开头 3 秒划走」。输入你的视频主题，返回 6 类经过验证的钩子句式（每类 2 条，已代入你的主题，可直接照着口播），外加四大平台的节奏建议。

每次成功调用 ¥0.05（支付宝 AI 按量付费 / A2M 协议自动收款）。

功能说明

输入视频主题关键词，返回：① 反常识/悬念/痛点/利益点/身份认同/数字盘点 6 类钩子，每类含情绪基调、适用题材与 2 条已代入主题的口播句式；② 短视频/视频号/种草平台/中长视频的节奏与收尾建议。输出 JSON 格式。服务端为纯本地句式模板库（无外部依赖），不外联第三方、不读取用户本地文件。付费采用支付宝 AI 按量付费（A2M 协议）：402 报价 → 用户支付 → 服务端验付 → 履约确认 → 返回结果。

适用场景

• 短视频口播稿开头 3 秒留不住人，完播率低
• 带货/科普/剧情多类题材，想按题材选对钩子类型
• 一条内容要发多平台，需要按平台调整节奏与收尾

不适用 / 能力边界

• 返回的是钩子句式与结构，不替代完整成片脚本与拍摄执行
• 句式为通用爆款结构，实际效果依赖内容质量与投放策略
• 不编造数据：句式中如需「X 万人都在用」类数据，请自行核实后填入

使用方法（A2M 四步完整流程）

第一步：请求资源（无凭证首调，预期返回 402）

GET https://gk-diagnose-308980-8-1461759720.sh.run.tcloudbase.com/api/viral-hook?theme=电动车充电

• theme：视频主题，必填，如 theme=电动车充电、theme=PLC 调试
• platform：可选，短视频 / 视频号 / 种草平台 / 中长视频，留空返回全部平台建议
• 也可用打包脚本一键走完整流程：python scripts/viral_hook_client.py --theme "电动车充电"

第二步：处理 402 账单

无有效凭证时返回 HTTP 402，响应头 Payment-Needed 为 Base64url 编码的账单（含订单号、金额、卖方 RSA2 签名）。把该头原样保存到仅当前用户可访问的安全文件，不得解码改写账单内容。

第三步：发起支付

读取 alipay-payment-skill，按其 402-buyer-pay 流程将账单交给支付宝收银：

alipay-bot 402-buyer-pay --session-id '<当前会话ID>' --file '<账单安全文件>' \
  --resource-url '<第一步的完整URL>' \
  --intent-summary '原始请求：生成黄金3秒口播钩子' --method GET

向用户展示收银二维码/链接，由用户在支付宝 App 内授权付款（首次使用需开通 Agent 支付）。

第四步：付款后取回结果（必须执行）

用户付款后按 alipay-payment-skill 取得 Payment-Proof，带 Payment-Proof 头重放第一步的同一 URL。服务端验付并履约后返回钩子结果，响应头 Payment-Validation 即履约确认凭证（请留存备查）。

触发示例

• 「给我一条电动车充电主题的短视频口播开头」→ 调用 theme=电动车充电&platform=短视频
• 「做收纳整理类视频，开头怎么留人？」→ 调用 theme=收纳整理
• 「写个 PLC 调试科普视频的爆款开头」→ 调用 theme=PLC调试

参数说明

示例输出

{
  "theme": "电动车充电",
  "hook_count": 6,
  "hooks": [
    {
      "type": "反常识钩子",
      "emotion": "惊讶→好奇",
      "适用题材": "知识科普/经验分享/避坑",
      "scripts": [
        "大多数人以为电动车充电的关键在A，其实恰恰相反——真正决定成败的是B",
        "电动车充电这事，90%的人第一步就做反了，难怪一直没效果"
      ]
    }
  ],
  "platform_notes": {"短视频": "前3秒必须出钩子，5-8秒一个信息增量，语速快、句子短，结尾用问句收"}
}

履约确认与订单持久化幂等（服务端保证）

• 订单持久化：每次 402 生成全局唯一 out_trade_no（前缀 GK + 毫秒时间戳 + 随机串），订单即时写入服务端 SQLite orders 表（out_trade_no 主键 + trade_no 唯一索引），含金额、商品名与 30 分钟支付时限。
• 服务端验付：收到 Payment-Proof 后，服务端先调支付宝「AI 按量付费验付接口」核验凭证真伪，并比对订单号、金额、商品一致性，任一不符按未支付处理。
• 履约确认：验付通过后执行支付宝「履约确认」接口，并以响应头 Payment-Validation 回传确认结果。
• 幂等：同一订单只履约一次——重放同一 Payment-Proof 直接复用已生成结果，不会重复扣费、不会重复计价；订单状态 UNFULFILLED → PENDING_CONFIRM → FULFILLED 全程留痕可对账。

测试验证

• 本地 FREE 模式实测：GET /api/viral-hook?theme=电动车充电&platform=短视频 → 200，返回 6 类钩子共 12 条句式（均已代入主题）+ 短视频节奏建议 ✅
• 线上 402 实测：部署后 GET /api/viral-hook?theme=测试 → HTTP 402，Payment-Needed 头携带账单 ✅（部署当日补记录）
• 服务端订单库可按 out_trade_no 对账查询 ✅

异常处理

• theme 缺失 → 422（参数校验），补 theme 重试
• 账单过期（30 分钟）或验付失败 → 再次返回 402 新订单，重新走支付流程即可
• 重放时未带 Payment-Proof → 按 402 处理，不会误判为已支付

版本更新

• v1.0.0（2026-09-15）：首发 6 类钩子句式库（12 条模板）+ 四平台节奏建议。

说明

• 服务端纯本地句式模板库，不外联、不读取用户文件
• 句式可直接照播，也可改写；涉及数据处请自行核实
• 内容由 AI 整理生成

与免费版的区别（请如实告知用户）

我们同时提供永久免费的 viral-hook-pro。两者分工如下：

建议路径：先用免费版确认钩子风格对不对（不花钱）；确认后若需要 6 类句式批量挑 + 四平台节奏，再用本版。