核心用法
Vidu Video Generation Skill 是一套基于 Python 脚本的异步视频生成工具，封装了 Vidu 平台的完整 API 能力。用户通过运行 scripts/ 目录下的脚本完成各类视频生成任务，无需自行实现 HTTP 调用。
主要功能模块：
- 文生视频 (text2video)：纯文本输入，Q3 模型支持 1-16 秒、多种宽高比及专业/快速两种生成模式；Q2 模型支持 2-8 秒
- 图生视频 (img2video)：单张图片 + 文本描述，宽高比由输入图自动决定
- 首尾帧生视频 (headtailimg2video)：首帧图 + 尾帧图 + 文本，实现场景过渡效果
- 参考生视频 (character2video)：结合图片、自定义主体(material element)和文本，支持人物一致性生成，仅 Q2 模型可用
- 主体创建与管理：上传 1-3 张图片创建可复用的 material element，用于参考生任务
执行流程：设置 VIDU_TOKEN → 运行 run_vidu_generation.py 提交任务 → 获取 task_id → 使用 get_task_result.py 查询结果。支持 SSE 流式状态监听获取实时进度。
显著优点
- 完整功能封装：覆盖 Vidu 全量 API，包括预上传、主体预处理、任务提交、状态查询、结果获取完整链路
- 异步架构设计：任务提交后立即返回 task_id，避免阻塞，适合集成到工作流
- 多区域支持：通过 VIDU_BASE_URL 自动适配中国大陆(
vidu.cn)与海外(vidu.com)服务节点 - 参数智能校验：脚本内置任务类型与模型版本的参数兼容性检查，自动过滤无效参数
- 主体复用机制：Material element 创建后可多次引用，实现角色一致性视频生成
潜在局限
- 环境依赖严格：必须配备 Python 3 和 requests 库，纯 API 调用环境无法直接执行
- 令牌管理敏感：VIDU_TOKEN 需用户自行配置，泄漏风险需人工管控
- 异步结果轮询：需用户或调用方实现定时查询逻辑，脚本本身不提供自动等待
- 主体创建复杂：涉及预上传→预处理→创建三步流程，学习成本较高
- 区域限制：Q3 高级功能仅限中国大陆节点，海外用户功能受限
适合人群
- 需要将 Vidu 视频生成能力集成到自动化工作流的技术团队
- 熟悉 Python 环境配置、能管理 API 令牌的中高级开发者
- 有批量视频生成、角色一致性控制需求的内容创作者
- 已具备 Vidu 平台账号和 API 访问权限的用户
常规风险
- 令牌安全风险：VIDU_TOKEN 若泄露可能导致账户被滥用，建议配置最小权限并定期轮换
- 内容合规风险：生成内容需遵守 Vidu 平台 AUP 及当地法规，敏感主题可能被拦截
- 任务失败处理：网络超时、参数错误、内容审核失败等均可能导致任务失败，需实现重试和降级逻辑
- 资源成本累积：视频生成按量计费，高频调用前需确认账户余额和配额
- SSE 连接稳定性：流式状态查询依赖长连接，弱网环境可能出现中断