Vidu 场景特效生成

解决什么问题

把照片直接变成短视频特效，常见痛点是：用户只会说“变身浩克”“走红毯”这类需求，却需要自己找模板 ID、拼 API 参数、轮询异步任务，还要处理 API Key、图片大小和链接时效。这个技能把 Vidu 的模板调用流程收敛成对话式入口，减少手工集成成本。

技能如何工作

• 模板匹配：根据用户描述从特效模板中选择对应 template_id，例如 hulk、fashion_stride、christmas。
• 照片约束：必须使用用户上传的照片；如果没有照片，需要先提醒上传，避免使用默认图。
• API 调用：依赖 VIDU_API_KEY，通过 Python CLI 触发异步生成，并轮询任务状态。
• 结果返回：下载素材到 {baseDir}/uploads/，最终返回 Vidu API 中 creations[0].url 的视频链接。
• 参数细化：部分模板支持额外参数，如 exotic_princess 的 area 和 beast_companion 的 beast。

适用边界与注意点

• 生成是异步任务，需要等待状态完成，不能只提交一次就取结果。
• 视频链接通常有时效，资料标注 24 小时内有效，适合尽快访问或二次下载。
• 模板 ID 需要匹配准确，错误 ID 会触发 Template not found。
• 图片过大会触发 Image size exceeds，建议控制在 50MB 以下。
• 域名选择会影响连通性：简体中文场景默认 api.vidu.cn，其他语言使用 api.vidu.com。