--- name: poyo-wan-2-2-fast description: 通过 https://api.poyo.ai/api/generate/submit 在 PoYo / poyo.ai 上执行 Wan 2.2 Fast 视频生成；适用于 wan2.2-text-to-video-fast、wan2.2-image-to-video-fast，支持快速文本生成视频、图像生成视频、首帧/末帧图像输入、480p / 720p 分辨率、种子（seed）控制、任务提交、轮询（polling）及 Webhook 回调。 metadata: {"openclaw":{"homepage":"https://poyo.ai/models/wan-2-2-fast","requires":{"bins":["curl"],"env":["POYO_API_KEY"]},"primaryEnv":"POYO_API_KEY"}}

PoYo Wan 2.2 Fast 视频生成

PoYo 相关链接

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

本技能用于在 PoYo 平台上执行 Wan 2.2 Fast 视频生成任务。它可协助智能体构建文本生成视频（text-to-video）或图像生成视频（image-to-video）的请求载荷（payload），异步提交任务，并说明后续轮询（polling）或 Webhook 回调的使用方式。

适用场景

• 用户明确提及 Wan 2.2 Fast、wan2.2-text-to-video-fast、wan2.2-image-to-video-fast 或 PoYo Wan 2.2 视频生成。
• 任务类型为基于提示词（prompt）的视频生成、单图动画（single-image animation），或首帧/末帧图像驱动的图像生成视频。
• 工作流需调用 PoYo 的异步任务提交接口、任务状态轮询，或需配置回调 URL（callback URL）。

模型选择

• wan2.2-text-to-video-fast：根据文本提示词生成视频。
• wan2.2-image-to-video-fast：对一张必选图像进行动画化处理；可选提供第二张图像作为视频末帧。

关键输入参数

• prompt 是 input 中的必填字段。
• aspect_ratio 仅适用于文本生成视频任务，支持文档中定义的横屏（landscape）或竖屏（portrait）取值。
• image_urls 是图像生成视频任务的必填字段，支持传入一个或两个图像 URL。
• resolution 可设为 480p 或 720p。
• seed 为可选参数，适用于需要可复现生成结果的场景。
• callback_url 为可选参数，适用于生产环境中的任务队列管理。

安全规范

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

执行说明

• 请查阅 references/api.md 获取接口地址详情、模型 ID、通用字段、示例载荷及轮询注意事项。
• 仅当用户明确希望从可信 Shell 环境中提交已准备好的 JSON 载荷时，才使用 scripts/submit_wan_2_2_fast.sh 脚本。
• 若用户仅需 curl 示例命令，请直接从 references/api.md 中选取并适配。
• 任务提交成功后，须清晰返回响应中的 task_id，以便后续轮询操作便捷执行。

输出预期

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

• 选定的模型 ID
• 请求类型（文本生成视频 or 图像生成视频）
• 最终请求载荷（payload）或简洁的参数摘要
• 所选分辨率、宽高比（aspect ratio）及 seed（如适用）
• 是否涉及单张或两张源图像
• 若已实际提交请求，则必须返回 task_id
• 下一步操作说明：轮询任务状态 or 等待 Webhook 回调