核心用法
Zopia 技能是一个项目制的 AI 视频创作代理，通过 Python 脚本与后端 AI Agent 交互，实现从创意到成片的完整 workflow。用户只需提供自然语言描述，系统自动完成剧本推演、角色设计、分镜生成、关键帧绘制、视频生成及最终合成。
典型 workflow：
1. 项目初始化：create_project.py 创建项目 → save_settings.py 配置风格/画幅/模型
2. 创作执行：send_message.py 发送需求 → query_session.py --poll 自动轮询进度
3. 成果获取：download_results.py 自动下载到本地目录 + 返回项目链接
4. 最终渲染：render_episode.py trigger 将分镜视频合成为完整 MP4
多集连续剧：单项目支持多 Episode，每集独立剧本/角色/分镜，共享项目级设置。续集创作时说明"沿用上一集角色"即可保持形象连贯。
显著优点
- 端到端自动化：无需人工拆分任务或编写 prompt，后端 Agent 自主完成创作 pipeline
- 多模型支持：集成 Seedance 2.0 Pro/Fast、Kling O3/V3.0、PixVerse、Hailuo、Wan 2.6、Vidu Q2/Q3 等主流视频模型，以及 GPT Image 2、Doubao Seedream 4 等图像模型
- 风格丰富：涵盖日韩动漫、Pixar 3D、吉卜力、新海诚、写实 3D CG、像素艺术等 9 种预设风格
- 智能进度追踪：workspace 实时快照清晰展示角色图、分镜图、视频片段的生成状态
- 云端渲染：支持将分镜视频自动合成为完整 MP4，1-5 分钟完成
潜在缺点与局限性
- 异步轮询机制：创作过程需持续轮询（建议 8 秒间隔），单次会话可能耗时数分钟至更久
- 余额门槛：创建项目需确认余额 ≥ 10，实际消耗按模型和分辨率计费
- 模型-方式匹配限制：不同视频模型支持的 generation_method 各异，配置错误会直接报错（如 Wan 2.6 仅支持 start_frame）
- Token 有效期：ZOPIA_ACCESS_KEY 仅 30 天有效，过期需重新获取
- 渲染前置条件：必须至少有一个分镜完成视频生成，否则触发 render 会得到空内容
适合人群
- 短视频创作者、独立制片人：快速验证创意、生成概念片
- 广告/营销团队：批量生产风格统一的商业短片
- 动画工作室：前期分镜预演、角色设定可视化
- AI 艺术爱好者：探索文生视频、图生视频的创作边界
- 教育工作者/学生：影视制作流程教学演示
常规风险
- 成本不可控：视频生成按片段计费，长剧集或多轮迭代可能快速消耗余额，建议创作前执行
get_balance.py - 生成失败：网络波动或模型异常可能导致分镜或视频失败，需监控
failed计数器 - 内容合规：AI 生成视频存在版权、肖像权、伦理争议风险，商业使用需确认平台授权条款
- 会话冲突：同一 episode 同时只能有一个 running 会话，重复发送会返回 409 错误
- 下载时效：生成的媒体 URL 可能有时效限制，建议完成后立即下载