视频提示词构建器
通用、与提供商无关的视频生成提示词调度器。读取 .specs/architecture/PROVIDERS.md 中的路由矩阵,决定由哪个提供商执行,并委派给专门的构建器(higgsfield-prompt-builder、topview-prompt-builder、wavespeed-batch、hyperframes-prompt-builder)。
何时调用
- 流水线中的任何视频生成步骤(
brief -> script -> creative,当创意类型为视频时)。 - 当某个片段在
.specs/pieces/*.md中声明type: video时。 - 跨提供商进行视频钩子 A/B 测试,并且编排器需要一个单一入口点。
- 在 A/B 测试选出获胜者后,使用相同的 brief 在不同的提供商上重新运行。
- 当上游代理拥有 brief 但不知道选择哪个提供商时。
输入
brief:对象。视觉 brief,至少包含subject、motion、mood、aspect、duration_seconds。task_kind:字符串。可选值:cinematic_reel、motion_control、ugc_product_holder、product_demo、talking_head、batch_hook_test、motion_typography、data_viz_reel、programmatic_short。piece_path:字符串,可选。片段文件的路径。可能包含provider_override.video。dry_run:布尔值,可选。为 true 时,返回已解析的提供商和参数,而不调用 MCP。
处理流程
- 读取
.specs/architecture/PROVIDERS.md并将视频矩阵解析为task_kind -> provider映射。 - 如果设置了
piece_path且包含provider_override.video,则使用覆盖值。 - 否则在矩阵中查找
task_kind。如果未知,则回退到矩阵中cinematic_reel的默认值。 - 验证所选提供商是否已设置环境变量(
HIGGSFIELD_MCP_ACTIVE、TOPVIEW_API_KEY、WAVESPEED_API_KEY、HYPERFRAMES_ACTIVE)。 - 将提供商映射到专业技能:Higgsfield ->
higgsfield-prompt-builder,Topview ->topview-prompt-builder,Wavespeed ->wavespeed-batch,Hyperframes ->hyperframes-prompt-builder。 - 将
brief字段转换为专业技能期望的输入形状。 - 调用专业技能并捕获其
params和mcp_tool输出。 - 如果是
dry_run,则返回已解析的提供商、参数和 MCP 工具。否则调用 MCP 并返回工件引用。 - 将运行记录到
data/video-usage.jsonl中,包含时间戳、提供商、task_kind和结果。
输出
provider_used:字符串。params:对象。准备好用于 MCP 调用的最终参数对象。mcp_tool:字符串。MCP 工具名称。artifact_ref:字符串,非干运行模式时返回。生成的视频路径或 URL。cost_estimate_usd:数字。
示例
示例 1:路由到 Higgsfield 的电影短片
输入:{ brief: { subject: "model in linen suit", motion: "tracking shot", mood: "editorial", aspect: "9:16", duration_seconds: 6 }, task_kind: "cinematic_reel" }
输出:{ provider_used: "higgsfield", mcp_tool: "higgsfield_seedance_generate", params: {...} }
示例 2:路由到 Topview 的 UGC 广告
输入:{ brief: { subject: "skincare bottle held by avatar", motion: "static", mood: "friendly", aspect: "9:16", duration_seconds: 15 }, task_kind: "ugc_product_holder" }
输出:{ provider_used: "topview", mcp_tool: "topview_avatar_generate", params: {...} }
示例 3:路由到 Hyperframes 的周 KPI 短片
输入:{ brief: { headline: "Semana 21 em números", aspect: "9:16", duration_seconds: 12, variables: { leads: 42, delta_pct: 12 } }, task_kind: "programmatic_short" }
输出:{ provider_used: "hyperframes", mcp_tool: "hyperframes_render", params: { composition_spec: {...}, render_args: {...} } } — 通过 hyperframes + hyperframes-cli 技能进行本地渲染。
故障模式
task_kind不在矩阵中:记录警告并使用cinematic_reel默认值。- 所选提供商缺少必需的环境变量:降级到矩阵中的下一个提供商并显示警告。
- 专业技能返回错误:显示错误,除非调用方选择,否则不在不同提供商上自动重试。
- 时长超过提供商限制:裁剪到提供商最大值并显示通知。
相关技能
higgsfield-prompt-builder:Soul、DoP、Seedance 的专业构建器。topview-prompt-builder:UGC 和虚拟人驱动广告的专业构建器。wavespeed-batch:廉价批量钩子测试的专业构建器。hyperframes-prompt-builder:HTML 渲染的动态排版、数据可视化短片和参数化程序化短片的专业构建器。llm-router:文本生成的不同调度器;相同的模式,不同的领域。qa-tech-specs:根据平台规范验证最终视频。