技能介绍

解决的问题

Zopia AI 视频创作 面向的不是“输入一句话就出片”的简单调用，而是多阶段 AI 视频项目的管理问题：剧本、角色图、分镜关键帧、视频片段彼此依赖，生成过程异步且耗时，结果分散在不同媒体资源中。若直接用聊天式操作，容易出现上下文丢失、进度不可见、多集资产混乱、最终视频难以统一导出的情况。该技能把这些流程收敛成可脚本化的项目工作流。

工作方式

技能围绕 Project、Episode、Session 和 Workspace 组织：

创建与配置：先用 create_project.py 建项目，再用 save_settings.py 设置风格、画幅、视频模型、分镜图模型和角色图模型。
传达创作意图：用 send_message.py 将用户原始需求异步发给后端 Agent，避免在本地扩写或拆分任务。
追踪进度：用 query_session.py 轮询 workspace，通过 entities、storyboard.images.pending、storyboard.videos.pending 判断角色图、关键帧和视频片段处于哪一步。
获取与合成：完成后用 download_results.py 下载图片/视频；多集可用 manage_episodes.py；需要完整 MP4 时再用 render_episode.py 触发云端渲染。

适用边界

它适合把 Zopia 后端创作能力封装给脚本、Agent 或自动化流程，而不是在本地直接生成视频。使用时要注意：模型与 --generation-method 必须匹配；多集之间角色和分镜独立，跨集复用需在消息中说明；渲染 MP4 前必须至少有一个分镜已完成视频；连续失败或长时间无进展时应停止轮询并引导用户查看项目。