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":""}}}
返回 2.00 元支付宝账单:结果 code=Payment-Needed,含 out_trade_no 与
payment_needed(Base64URL 签名账单:金额 2.00、30 分钟有效、商家 RSA2 签名)。
按账单完成支付宝支付。
第 3 步:支付后用完全相同参数重试(凭证传入 payment_proof)
payment_proof 传入支付凭证后重试 → 返回制作蓝图:pipeline(选型与理由)、
stages(阶段计划)、scene_plan(分镜表)、platform_playbook(按画幅识别平台:
竖屏/横屏/方形的完播基准、前 3 秒法则、标题公式与封面要点)、
hook_formulas(开场钩子公式×5,已结合主题生成示例)、pacing_guide(按时长的
节奏密度)、retention_tactics(留存战术)、publish_checklist(发布自查)、
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
输出纪律
- 成品交付:结果中的框架/样例若含
{占位},由你(对话助手)结合用户的真实信息补全为可直接使用的成品;上下文没有的事实最多追问 1 次;禁止编造数据与事实; - 不虚构:结果未覆盖的信息如实说明「需补充什么」,不假装已知;引用外部信息注明来源。
交付与计费纪律
- 交付状态机:首次调用返回账单(402,内含 pay_url 收银台直链,支付宝/微信均可付)→ 用户付款后回复「付好了」→ 系统自动查单交付完整结果,无需任何凭证;
- 换参数=新问题=新账单:出账单后不要更换参数重试;想改条件请开新对话重新描述。