Zopia Skills

核心功能

Zopia 是一个项目制的 AI 视频创作平台，采用「剧本 → 角色 → 分镜 → 视频」的完整流水线，由后端 AI Agent 自动驱动。用户无需掌握复杂的 prompt 工程或分镜设计，只需用自然语言描述创作意图，即可完成从概念到成片的系统化视频创作。

显著优点

端到端自动化：不同于单一的文生视频工具，Zopia 覆盖剧本创作、角色设计、分镜规划、关键帧生成、视频渲染的全流程，AI Agent 自动拆解任务并调度资源。

多模型支持：集成 Stardust 2.0、Kling O3/V3.0、Hailuo、Wan 2.6、Vidu Q2 Pro/Q3 Pro 等主流视频模型，支持文生视频、图生视频、多参考生成等多种模式，可按需选择。

多集连续剧能力：一个项目可包含多集剧集，每集独立管理剧本、角色、分镜，同时共享项目级风格设置，适合短剧系列化制作。

丰富的视觉风格：内置 9 种风格（日韩动漫、3D CG 写实、Pixar 卡通、真人写实、新海诚、吉卜力、像素艺术等），支持 16:9/9:16 画幅与多种分辨率。

潜在局限

依赖平台余额：创作消耗 credits，余额不足时无法继续，需提前确认余额 ≥ 10。

异步执行等待：视频生成耗时较长，需轮询追踪进度，极端情况下可能超过 3 分钟无响应。

风格一致性挑战：多集连续剧中角色跨集一致性依赖后端 Agent 处理，复杂角色可能存在细微漂移。

生成方式与模型强绑定：不同视频模型支持的生成方式不同（如 Hailuo 仅支持 start_frame，Kling O3 支持 multi_ref_v2），配置不当会直接报错。

适合人群

• 短剧创作者、独立视频制作人
• 广告/营销团队快速产出概念视频
• 动画预演、分镜师视觉化剧本
• 需要批量生成角色设定图、关键帧的概念设计师

常规风险

• Token 过期：ZOPIA_ACCESS_KEY 30 天有效，过期后需重新获取
• 余额耗尽：创作前务必调用 get_balance.py 确认
• 会话冲突：同一项目同一剧集同时只能有一个 running 会话，409 错误需等待当前任务完成
• 资源下载依赖：生成完成后需主动下载，长时间未下载可能存在链接过期风险

核心用法

Zopia 是一个项目制的 AI 视频创作平台，通过后端 AI Agent 自动驱动完整流水线：剧本 → 角色 → 分镜 → 视频。用户通过 Python 脚本管理项目、传达意图并获取成果，无需手动扩写或拆分任务——后端 Agent 会自动处理创作细节。

关键流程

1. 环境配置：设置 ZOPIA_ACCESS_KEY（30天有效）
2. 创建项目：自动生成首集，获取 baseId 和 episodeId
3. 项目设置：配置风格（如吉卜力、赛博朋克）、画幅（16:9/9:16）、视频模型
4. 发送指令：将用户原始描述原封不动传给后端 Agent
5. 轮询追踪：自动监控生成进度（角色图 → 分镜关键帧 → 视频片段）
6. 自动下载：完成后下载到本地，同时提供项目链接供浏览器编辑

显著优点

• 零依赖：仅使用 Python 标准库，无第三方包风险
• 专业 Agent 后端：内置视频/图像生成专家，自动处理 prompt 工程和创作流程
• 多剧集支持：单项目可管理多集连续剧，角色和分镜独立但风格统一
• 多模型选择：支持 Kling、Seedance、Wan、Vidu 等主流视频模型，各有特色生成方式
• 实时进度透明：通过 workspace 快照精确掌握每步状态

潜在局限

• 付费门槛：需预充值余额，余额不足会直接报错（402）
• 异步等待：视频生成耗时较长，需轮询等待（建议8秒间隔，3分钟无进展需人工介入）
• Token 有效期：30天需续期，过期需重新获取
• 模型限制：不同视频模型支持的生成方式差异大，配置不当会报错

适合人群

• 短剧创作者、独立视频制作人
• 需要快速可视化剧本的编剧/导演
• 动漫/IP 角色设计与世界观构建者
• 批量生成素材的广告/营销团队

常规风险

• 余额耗尽中断：建议创作前先用 get_balance.py 确认
• 会话冲突：同一项目同时只能运行一个 session（409错误）
• 模型参数不匹配：如给 Kling O3 配 start_frame 会失败，需严格对照表格
• 网络超时：生成大视频时建议配置更长超时或分批次处理