--- name: poyo-wan-animate description: 通过 https://api.poyo.ai/api/generate/submit 在 PoYo / poyo.ai 上执行 Wan Animate 视频生成；适用于 wan-animate-replace、wan-animate-move、角色动画、角色替换、单源视频 URL、单目标图像、480p / 580p / 720p 输出、轮询（polling）及 Webhook 回调。 metadata: {"openclaw":{"homepage":"https://poyo.ai/models/wan-animate","requires":{"bins":["curl"],"env":["POYO_API_KEY"]},"primaryEnv":"POYO_API_KEY"}}

PoYo Wan Animate 视频生成

PoYo 相关链接

• 模型页面：https://poyo.ai/models/wan-animate
• API 文档：https://docs.poyo.ai/api-manual/video-series/wan-animate
• API 密钥页面：https://poyo.ai/dashboard/api-key

该技能用于在 PoYo 平台上执行 Wan Animate 任务。它可协助智能体构建角色动画或角色替换的请求载荷（payload），提交异步任务，并说明后续轮询或 Webhook 回调机制。

适用场景

• 用户明确提及 Wan Animate、wan-animate-replace 或 wan-animate-move。
• 任务需基于源视频对角色图像进行动画化，或执行角色替换流程。
• 工作流需调用 PoYo 异步任务提交接口、轮询任务状态，或需配置回调 URL 指导。

模型选择

• wan-animate-replace：适用于将源视频中的某角色，替换为目标图像中的角色。
• wan-animate-move：适用于使用源视频中的运动信息，驱动目标角色图像生成动画。

关键输入参数

• video_url：必需，指向源视频的可访问 URL。
• image_urls：必需，且必须且仅包含一个目标图像 URL。
• resolution：可选，支持文档中定义的输出分辨率值（如 480p、580p、720p）。
• callback_url：可选，适用于生产环境中的队列式任务处理。

安全规范

• 将 POYO_API_KEY 视为敏感凭据，严格保密。
• PoYo API 密钥应仅存储于服务端环境变量或后端密钥管理器中。
• 严禁将 API 密钥置于浏览器端代码、前端打包产物、公开仓库、日志、截图或聊天输出中。
• 除非用户明确要求且已确认运行于安全的服务端环境，否则不得发起真实 API 调用。
• 除非用户明确信任 PoYo 及回调接收方，否则不得提交含私人肖像的图像、私人视频、私人提示词（prompt）或私人回调 URL。

执行方式

• 查阅 references/api.md 获取接口详情、模型 ID、通用字段、示例载荷及轮询说明。
• 仅当用户希望从可信 Shell 环境中提交已准备好的 JSON 载荷时，才使用 scripts/submit_wan_animate.sh 脚本。
• 若用户仅需 curl 示例命令，请直接参考并适配 references/api.md 中提供的范例。
• 提交成功后，须清晰返回 task_id，以便后续轮询操作顺利进行。

输出预期

在协助 Wan Animate 相关任务时，输出内容应包含以下要素：

• 选定的模型 ID
• 请求类型：角色替换（character replacement）还是角色动画（character animation）
• 最终请求载荷（payload），或简明的参数摘要
• 源视频与目标图像各自的角色定义（即“谁驱动动作”、“谁被驱动”）
• 如已指定，则注明所选分辨率
• 若已实际提交请求，则返回 task_id
• 下一步操作指引：轮询任务状态，或等待 Webhook 回调