企业官网建设流程全解析

MeiGen AI Design MCP 是一个开源的 AI 图像与视频生成 MCP 服务器，支持 GPT Image 2、Seedance 2.0 与本地 ComfyUI，内置 1,400+ 精选提示词，并提供了多任务编排能力：把 MeiGen 当作一个"可调用的生成步骤"，嵌入你已有的 Agent、脚本或应用中，即可实现N 个脚本 → N 张首帧 → N 段视频的批量流水线。本文用尽量少的代码，带你完整理解这套多任务编排的工作机制。

什么是"可组合工作流"？

传统用法是"你说一句，AI 画一张"。而可组合工作流（Composable Workflow）的思路完全不同：

• 上层拥有控制权：创意计划、提示词、模型选择、数量、预算和最终展示，全部由你的 Agent 或脚本决定；
• MeiGen 只负责执行：generate_image、generate_video变成流水线中可编排的"原子步骤"；
• 结果可恢复：每一步都有持久化的任务句柄，进程重启、网络中断后都能找回结果，不会重复扣费。

简单说：你写 N 个脚本，MeiGen 帮你批量跑通"出图 → 出视频"的整条链路。官方完整说明见 COMPOSABLE_WORKFLOWS.zh-CN.md。

编排四大核心工具：一次看懂任务流水线

多任务编排依赖 4 个关键工具，全部通过 MCP 调用（源码位于 src/tools/）：

💡 视频生成必须指定模型，具体哪些模型支持参考视频/首帧，以list_models的实时返回为准。实现细节可参考 generate-video.ts 和 check-generation.ts。

关键参数：requestId、wait 与 nextAction

这是整套编排的"骨架"，理解 3 个概念就够用了：

1. requestId（UUID）：每个逻辑步骤提交前先生成并持久化保存一个 UUID。恢复时沿用原 ID，只有真正的新付费尝试才换新 ID——这是避免重复计费的核心；
2. wait: false：提交后立即返回任务句柄，不阻塞等待，实现并行提交；
3. nextAction：返回结果中的"下一步指令"，包含该调用的工具名和参数，照做即可推进流程，无需解析人类可读文案。

结果统一从structuredContent中读取：status（processing / completed / failed）、urls、creditsUsed、pollAfterSeconds等字段，工作流据此自动推进。

N 脚本 → N 张首帧 → N 段视频：五步编排流程

以"10 个分镜脚本，各生成一张首帧再转一段视频"为例，完整流程如下：

第 1 步：创建计划并保存 ID每个脚本预先创建两个 UUID（首帧一个、视频一个），连同精确输入一起保存。只在创建工作流时执行一次，重跑或恢复时绝不重新分配。

第 2 步：预算预留每次新提交前，按当前模型价格预留预计费用，并计入所有在途预留；返回后用实际creditsUsed和已确认退款核算。

第 3 步：有限并发提交首帧独立的generate_image步骤采用有限并发（本地 npm 版最多4 个共享提交槽位），每次响应立即保存。首帧完成后，把选定的图片 URL 固定为该视频步骤的firstFrame输入——即使模型返回多张候选图，依赖关系也保持稳定。

第 4 步：提交视频生成generate_video接收firstFrame（首帧 URL），还可携带referenceVideos（最多 10 段）和referenceAudios（最多 10 段，参考音频免费），并在提示词里用 "Video 1" / "Audio 1" 指名引用。提示词中写 "extend / continue" 才能让新片段在语义上延续参考素材。

第 5 步：查询、恢复与交付用已有的任务句柄轮询或恢复，宿主重启后读取保存的计划继续查询待完成步骤；最终把完成视频和失败/未明确的步骤交回上层处理。

断点恢复：中断不丢任务、不重复扣费

这是多任务编排最实用的能力。COMPOSABLE_WORKFLOWS.zh-CN.md 给出了完整的恢复决策表，常见场景简化如下：

一句话原则：已提交 ≠ 已完成；任何不确定状态，先查询，后行动。恢复查询可跨宿主/进程重启生效（check-generation.ts），不只依赖本地缓存。

并发与预算：3 条避坑建议

1. 限制两件事：本地 npm 版限制"提交并发"（4 槽位），ComfyUI 执行器一次只跑一个任务；同时限制未完成的付费任务数量。
2. 预算由调用方管理：预算不是服务端原子执行的整批上限，估价可能变化；独立步骤可能部分成功，失败不会回滚已完成的首帧或视频。
3. 查询不占槽位：check_generation、下载都不占用提交槽位，可以放心高频轮询。

快速开始：搭建你的第一条编排流水线

前置条件：本地 npm 需meigen2.0.1 或更高版本（2.0.0 不支持referenceVideos/referenceAudios），远程端点为https://www.meigen.ai/api/mcp。

1. 连接 MCP 客户端：在 Claude Code、Cursor、Codex 等任意 MCP 兼容工具中接入（详见 README.zh-CN.md）；
2. 验证连接：让助手执行list_models和list_skills，确认工具可用且不消耗积分；
3. 编写上层计划：准备 N 个脚本（提示词 + 参数 + 两个 UUID），按上文五步流程编排提交；
4. 按需增强：可搭配 prompt-crafter.md 子 Agent 批量生成不同风格提示词，或用 image-generator.md 执行器委托生图步骤。

✅ 最小调用示例（异步提交 + 按 nextAction 推进）可直接参考 COMPOSABLE_WORKFLOWS.zh-CN.md 的"最小调用"章节。

常见问题

Q：远程 MCP 和本地 npm 版在工作流上有区别吗？有。download: false仅本地 npm 支持；远程 MCP 直接返回 URL 且没有download参数。参考视频/音频传本地文件路径也只有本地 npm 会自动上传，远程只接收 MeiGen CDN 的 URL。

Q：为什么视频任务不能"盲重试"？因为视频按秒计费，重复提交 = 重复扣费。所有重试都必须走check_generation确认状态，且失败后的替代任务属于新的付费尝试。

Q：MeiGen 创意助手是必须的吗？不是。创意规划和插件 Agent 都是可选能力，任何工作流都可以直接调用生成工具。

延伸资料

• 可组合工作流完整规范：COMPOSABLE_WORKFLOWS.zh-CN.md · COMPOSABLE_WORKFLOWS.md
• 五项 Skills HTTP API：SKILLS_API.md
• 项目主文档：README.zh-CN.md（含"接入已有工作流"章节 L407-L417）
• 生成任务状态契约：generation-contract.ts · 恢复存储：attempt-store.ts

掌握了requestId + wait:false + nextAction这三板斧，你就能把 MeiGen AI Design MCP 从"单张生图"升级为一条可恢复、可并发、可预算控制的批量视频生产线。🚀