拍立叙一键成片（付费）

概述

拍立叙一键成片（付费 Pay Skill）

把一组照片 + 一句主题/文案，生成有质感的早安问候或旅行回顾短视频。本 Skill 是调用壳：接收参数 → 校验 → 转发到拍立叙后端视频生成 API → 轮询任务状态 → 返回成片 URL。核心成片逻辑（Seedance / FFmpeg / 配音 / 字幕 / BGM）运行在拍立叙自有服务器，不随本 Skill 包上传（源码不外泄）。

触发场景

• 用户说「用这几张照片做个早安视频」「把旅行照片剪一段 20 秒短视频」「生成一段带旁白的问候片」。
• 输入：照片路径列表（建议 2–5 张）+ 主题（如「早安」「旅行回顾」）+ 可选文案。
• 输出：成片视频 URL（异步生成，沙箱壳轮询返回）。

支付声明（X402 / WeixinPay-Required）

本 Skill 为 Pay Skill，已按 SkillHub 微信 Agent Pay（X402 协议）完成改造：

1. 首次调用 generate 时，后端返回 HTTP 402 与 WeixinPay-Required 支付码；
2. SkillHub 平台将 WeixinPay-Required 作为 paymentCode 交给 weixinpay_pay 向用户申请微信支付授权；
3. 用户支付成功后，平台再次调用本壳并注入 X-Out-Trade-No；
4. 后端查单验证通过后创建视频任务，沙箱壳轮询 /api/status 直到 completed，返回成片 video_url。

价格由商家在 SkillHub 后台设定（建议 ¥1.90/条 早安、¥3.90/条 旅行回顾）。

注：pay: true / pay_price 为支付能力声明字段；SkillHub 后台「简易改造教程」若有正式字段名，以后台为准。

前置检查与异常处理

前置检查

本 Skill 为 Pay Skill，首次调用依赖 SkillHub 平台识别 HTTP 402 响应并自动调用 weixinpay_pay 插件完成微信支付授权。运行前请确保：

• SkillHub 运行环境已安装 weixinpay_pay 插件/工具；
• 环境变量 PAILIXU_VIDEO_API 与 PAILIXU_VIDEO_TOKEN 已正确配置；
• 后端服务 https://pailixu.com.cn 可正常访问。

若 weixinpay_pay 不可用，首次调用将无法完成支付授权，本 Skill 不会执行后续成片逻辑。

异常处理

• 未支付/支付失败：用户拒绝支付、支付超时或微信支付失败时，平台不会向本 Skill 注入 X-Out-Trade-No，本 Skill 不调用后端成片接口，直接返回当前错误提示，不扣次数、不创建视频任务。
• 支付后查单未支付：重试时后端若发现订单仍未支付，返回「订单未支付，请完成支付后重试」，不创建视频任务。
• 退款政策：本 Skill 提供的是一次性数字内容生成服务，视频一旦开始渲染即视为消费完成，不支持退款。
• 网络/后端超时：后端不可达时返回可理解的错误信息；视频渲染为异步任务，若轮询超时返回当前任务状态与 task_id，用户可稍后查询。

运行方式（沙箱壳）

SkillHub 云端沙箱执行入口为 skill_cli.py（遵循平台 python skill_cli.py <tool> --args 约定）：

python3 skill_cli.py generate --theme 早安 --caption "新的一天，亮堂堂" --photos /path/a.jpg /path/b.jpg

脚本行为：

1. 校验参数（照片数、格式、主题非空）；
2. 携带 Bearer 令牌（环境变量 PAILIXU_VIDEO_TOKEN）POST 后端 PAILIXU_VIDEO_API/api/generate；
3. 首次调用返回 402 + WeixinPay-Required + X-Out-Trade-No，由平台完成微信支付；
4. 支付成功后重试，本壳透传 X-Out-Trade-No Header，后端查单履约后创建任务；
5. 拿到 task_id 后轮询 /api/status 直到 completed；
6. 输出成片 video_url。

工具（tools）

• generate：生成早安/旅行回顾视频。参数 --theme（主题）--caption（文案，可选）--photos（照片路径，1 个或多个，必填）。

环境变量（沙箱壳配置）

• PAILIXU_VIDEO_API：拍立叙后端视频网关地址（商家在 SkillHub 后台填入，例如 https://pailixu.com.cn）
• PAILIXU_VIDEO_TOKEN：后端网关 Bearer 令牌（商家注入，沙箱壳不落地明文）
• X_OUT_TRADE_NO（可选）：SkillHub 平台在支付后重试时注入的 X402 订单号，本壳自动透传给后端

隐私与合规

• 照片仅在生成请求期间经 HTTPS 传输到商家后端，生成完成不留存、不训练。
• 后端强制走成本闸（AI 张数 ≤2、单段 5s、日预算 20 元、片段缓存复用），调用成本可预测。
• 本 Skill 不含任何服务器 IP、账号密码等敏感信息。

依赖

• Python 3.10+，httpx（运行时由沙箱环境提供）