AI 视频生成真正进入批量生产后，最先暴露的往往不是画质，而是任务管理：一张表里有几十个镜头，模型接口是异步的，网络会超时，下载会中断，Key 可能轮换，某个请求到底有没有创建成功也未必能马上确认。

如果系统在这些不确定状态下简单地“再试一次”，就可能重复生成、重复扣费，甚至把同一集短剧生成两遍。

PowerTokens/video-studio 是一个面向 Windows 的 Wan 3.0 视频批量生成工具。它把单条生成、Excel/CSV 批量导入、连续剧人物设定、任务 ID 恢复、断点下载、Key 池、CLI 和 MCP 放进一个桌面工作流里。

截至 2026 年 10 月 1 日，仓库约 1 Star，采用 MIT License，主要代码是 Python，当前只支持 Wan 3.0 视频模型。本文依据源码、中文使用说明、示例 Excel、变更记录和界面素材进行整理，并实际用示例表完成了本地解析验证；没有调用 PowerTokens 付费接口，也没有生成真实视频。

— Wan 3.0 生成的短剧片段示例

单条文生视频很容易理解：输入 Prompt，选择时长和分辨率，提交任务，等待 MP4。

短剧生产却不是这样。一个三集短剧可能至少有三行表格，每行都要保存人物、场景、动作、镜头、时长、比例和输出路径；当数量扩大到几十个镜头时，真正需要的是一个小型任务系统：

01能从 Excel 读取镜头清单。

02能识别每行的时长、分辨率和比例。

03能为每一行分配稳定身份。

04能限制生成和下载并发。

05能把云端任务 ID 先写入本地。

06能从中断位置继续查询或下载。

07能区分明确拒绝、请求超时和“结果不确定”。

Video Studio 的产品形态因此更接近“桌面端批处理控制台”，而不是单纯的 Prompt 输入框。

— Video Studio 的单条生成界面

单条生成界面支持 2～30 秒、720p/1080p、16:9/9:16/1:1，以及首帧、尾帧、参考图片、参考视频、参考音频链接和随机种子。

工具还会从 Prompt 中识别参数。例如：

01“16 秒，9:16 竖屏”会填入时长和比例。

02“0-5 秒……5-10 秒……”会从分镜时间轴推断总时长。

03英文的 total length 15s、00:00-00:03 同样可以识别。

识别优先级是“明确总时长”高于“开头时长”，再高于普通独立时长，最后才使用分镜时间轴。冲突时工具会提示修改，不会直接提交。

这类输入层校验很重要：如果时长和比例在请求发出后才发现错误，代价已经从“改文字”变成了“可能已经扣费”。

每次生成默认开启 Wan 3.0 原生音频，描述中可以直接写环境声、对白或音乐要求。

— Video Studio 的批量导入界面

示例表格一行对应一集或一个镜头，核心列包括：名称、时长、分辨率、比例和完整 Wan 3.0 Prompt。

当前导入器支持 .xlsx 和 .csv，同时识别中英文表头。参数列优先于 Prompt 自动识别；缺省值是 5 秒、720p、16:9；空行跳过；没有 Prompt 表头的工作表跳过；公式参数会被拒绝；每批最多 2000 行。

本轮使用仓库中的三集示例表做了本地解析验证：成功解析 3 行，状态均为 queued，每行生成稳定的 16 位行 ID，并得到同一批次的 24 位批次 ID。由于没有 API Key，验证停在提交前，没有产生真实费用。

这说明 Excel 在这里不是“导入文本的方便入口”，而是 任务规格文件：它定义了要生成哪些行、每行的请求参数以及批次身份。

短剧最难复用的不是单个镜头，而是人物一致性。

Video Studio 允许在批量导入前填写一段“全剧人物设定”，然后自动加到每一行 Prompt 前面。中文 Prompt 使用“全剧固定人物设定 / 本集剧情”分段，英文 Prompt 使用 [Series characters] / [This episode]。

这不是模型级角色锁定，也不保证每一帧外貌完全一致。它解决的是工程层面的重复劳动：每一集都携带同一份人物约束，减少用户手工复制时漏掉服装、发型和角色关系的风险。

人物设定还参与批次身份计算。修改设定后重新导入，系统会把它视为新批次；否则恢复逻辑可能把“人物已变化”的请求误认为原任务。

— Excel 批量生成的任务身份与状态架构

导入器为每行计算：

批次则把工作表名、行号、规范化后的 Prompt 和请求参数序列化后计算：

这里有两个层次：

01行 ID 识别某个表格行。

02批次 ID 识别整份输入内容。

重新导入内容不变的同一张表时，系统能找到原批次文件；已经完成的行跳过，已有任务 ID 的行只进入恢复流程。只改 Prompt、参数、行顺序或工作表名，批次 ID 就会变化，被视为新批次。

这就是批量生成中的幂等基础：先判断“是不是同一份工作”，再决定“这一行是否需要再次提交”。

提交云端视频任务后，最危险的窗口是“请求已经发出，但客户端没有拿到明确响应”。

如果客户端此时直接重试，可能出现两种结果：第一次已经成功创建任务，第二次又创建一份；第一次根本没创建，第二次才是有效任务。客户端无法凭感觉判断，只能把状态分成不同类型。

Video Studio 的关键顺序是：

01付费 POST 前先把本行标记为 running。

02获得任务 ID 后立即写入任务记录。

03后续查询和下载都围绕这个任务 ID。

04超时、5xx、网络错误或返回不明确时，不自动重新提交。

05只有“没有任务 ID，且服务明确拒绝”时，才允许换下一个 Key。

因此，“重试”被拆成两种完全不同的动作：

01查询重试：可以继续查同一个任务。

02生成重试：可能再次扣费，只有明确拒绝且没有任务 ID 才允许。

— 任务状态、恢复与断点下载流程

点击“停止等待”只停止本机轮询，云端任务仍可能继续并计费。任务 ID 会保留在本地记录中，之后可以在任务历史页继续查询。

批量状态包括 queued、running、completed、paused、uncertain、failed、invalid 和 deferred_403 等。状态不是装饰，它决定下一次允许做什么：

01completed：跳过，不重复生成。

02有任务 ID 的 paused：只查询和下载。

03uncertain：先人工确认，不自动补发。

04deferred_403：先处理其他行，最后用原 Key 再查一次。

05invalid：参数有误，永远不应提交。

进程意外退出时，批次文件和独立任务检查点会被重新读取。若发现任务 ID，行会恢复为暂停状态；如果没有任务 ID，只保留为不确定状态，不悄悄变回可提交队列。

生成任务完成不等于 MP4 已经安全落盘。下载可能中断、CDN 可能返回 403、磁盘写入可能被终止。

Video Studio 的下载器使用：

01.part 临时文件，避免未完成文件伪装成最终 MP4。

02HTTP Range，从已有偏移继续下载。

03续传前检查前后交界的 64KB 内容。

04ETag、Last-Modified、文件大小和 MP4 ftyp 头校验。

05验证通过后才把 .part 改成 .mp4。

06单独保存下载校验记录，重复恢复时可以跳过已完成文件。

这让“下载重试”也变成幂等操作：重试是继续同一份文件，而不是另存一份同名或损坏的结果。

批量生成允许 1～8 个生成并发，下载允许 1～4 个并发。两个并发数分开控制，因为生成和下载消耗的资源不同。

多个 API Key 会按行轮换首选 Key，但多个 Key 不等于平台给了更多算力。Key 只有在提交被明确拒绝、且尚未得到任务 ID 时才会切换；提交超时、5xx 或结果不确定时不会自动换 Key 重提。

费用估算按视频秒数和分辨率计算，界面、CLI 和 MCP 共用一套价格函数。当前快照记录 Wan 3.0 在 2026 年 10 月 7 日前使用折扣口径，实际扣费以 PowerTokens 账单为准。

成本控制的本质不是把失败都吞掉，而是把每一次可能产生费用的 POST 变成可追踪、可恢复、可解释的事件。

— Video Studio API Key 与 MCP 入口

项目提供一个小型 MCP 服务，暴露四个工具：

01check_key：显示 Key 数量和服务是否就绪，不访问接口。

02estimate_cost：按时长和分辨率估算费用。

03generate_video：提交 Prompt、等待任务并下载 MP4。

04resume_video：使用任务 ID 查询和下载已有任务，不重新生成。

MCP 服务本身通过 pt_wan.py 调用同一套核心引擎，桌面端、CLI 和 MCP 不各自实现一套请求协议。这样，Agent 可以把“先估价—生成—中断—恢复”串成一个有状态工作流。

但自动化仍需保留人工门槛：视频生成是付费动作，Agent 不应该在没有用户确认预算和输出路径时无限批量提交。

桌面端默认只把 Key 放在内存里；用户勾选记住后，Windows 端使用 DPAPI 加密保存到当前账户。

任务记录不保存完整 Key，只保存 SHA-256 指纹前 16 位和末 4 位，用于恢复时找到原 Key。API Key 只发送给配置的 API 主机，跨域跳转到 CDN 或存储域名时会移除 Authorization 头。

但是，CLI 配置路径是一个明确的安全例外：python pt_wan.py config --add-key 会把 Key 明文写入本地配置文件。项目公开说明建议优先使用环境变量，并且不要提交 CLI 配置文件。

这个反例很值得写进工程设计：同一个项目里，桌面端凭证保护和 CLI 凭证保护可能不是同一等级；文档把例外说清楚，比笼统宣称“Key 已加密”更可信。

适合把短剧拆成独立 2～30 秒镜头、需要批量生成并在失败后继续的团队或个人：

01Excel 管理每集 Prompt、时长、比例和分辨率。

02全剧人物设定统一注入每集 Prompt。

03任务完成后按行下载和导出结果 CSV。

04需要时通过 MCP 让 Agent 调用同一套生成/恢复接口。

它不负责自动把几十个片段拼成一条长剧，也不负责跨镜头保证角色视觉一致性。它提供的是“批量任务和可靠交付”这一层，镜头剪辑、连续性审核和最终成片仍需要后续工具。

Video Studio 的工程价值不在于把 Wan 3.0 调用包装成了一个更大的按钮，而在于它承认异步 API 天生不可靠：提交可能超时、状态查询可能 403、下载可能断点、Key 可能不可用、用户可能关闭窗口。

在这些情况下，最重要的不是“尽快再试一次”，而是保留任务身份，明确当前状态，允许人工恢复，并且避免把一次不确定请求变成第二次收费任务。

这套模式可以迁移到图片生成、音频生成、长任务推理和任何异步付费 API：输入要有稳定批次身份，提交要先保存任务 ID，恢复只查原任务，下载要可校验，失败要区分明确拒绝与结果不确定。

声明：本文由山行整理自：PowerTokens/video-studio（https://github.com/PowerTokens/video-studio），如果对您有帮助，请帮忙点赞、关注、收藏，谢谢～