video-blueprint（视频制作蓝图技能）

面向智能体的视频制作策划付费技能，按次结算。传入视频主题（如"关于深海热泉的 60 秒科普短片"），返回视频制作蓝图：流水线选型（12 条真实生产流水线之一，含选型理由）、执行制作人的阶段计划（各阶段产出物、可用工具、审查要点与成功标准）、确定性分镜表（角色化分场 + 时长分配）与预算参考。

调用方式（MCP Streamable HTTP，三步会话流）

入口：POST https://zvex.cn/videoblueprint/mcp

每次调用需完整走一遍会话流（Content-Type: application/json， Accept: application/json, text/event-stream）：

第 1 步：初始化（拿会话）

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"<你的名字>","version":"0"}}}

从响应头取 mcp-session-id，随后每个请求都带上它；再 POST 一次 {"jsonrpc":"2.0","method":"notifications/initialized"}（响应 202 即可）。

第 2 步：收费调用（首次，payment_proof 留空）

{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"plan_video_production","arguments":{"topic":"关于深海热泉的60秒科普短片","duration_seconds":60,"aspect_ratio":"16:9","language":"zh","payment_proof":""}}}

返回 0.50 元支付宝账单：结果 code=Payment-Needed，含 out_trade_no 与 payment_needed（Base64URL 签名账单：金额 0.50、30 分钟有效、商家 RSA2 签名）。按账单完成支付宝支付。

第 3 步：支付后用完全相同参数重试（凭证传入 payment_proof）

payment_proof 传入支付凭证后重试 → 返回制作蓝图：pipeline（选型与理由）、 stages（阶段计划）、scene_plan（分镜表）、budget（预算参考）、 trade_no/out_trade_no、fulfillment_confirmed=true。

注意

同一账单幂等：重复用相同参数重试不会重复扣费
支付后必须用完全相同的 topic/pipeline/duration_seconds/aspect_ratio/language 重试，参数变了验付失败（防串单）
pipeline 可用 video_blueprint_info 查询 12 条流水线名单，留空按主题关键词自动选型
duration_seconds 支持 15–600 秒；aspect_ratio 支持 16:9 / 9:16 / 1:1 / 4:5
凭证无效会返回新账单；临时失败（履约确认失败）用同一凭证重试，勿重复付款
蓝图是制作计划：各阶段需在本地视频制作环境中由对应 skill 执行，成片渲染在用户本地环境完成

免费工具

video_blueprint_info：返回能力、定价、流水线名单与付款协议说明，不产生账单。

详细文档

会话流、工具入参/结果与账单结构：references/api.md

常见问题（topic 写法/自动选型/两档凭证用法/蓝图怎么用）：references/api.md 的「常见问题（FAQ）」章节。

免费概要：首次调用未支付时,账单响应附带 preview——选型流水线名+阶段计划骨架,免费判断价值,付费解锁全文(防反推:概要露定位,不含干货)。