核心用法
PoYo Omni Flash Video Generation Skill 是一个专注于AI视频生成的工具型技能，通过封装 PoYo 官方 API (api.poyo.ai)，为 Agent 提供完整的视频生成工作流支持。该技能支持四种核心生成模式：text-to-video（文本生成视频）、single-image video（单图生成视频）、three-image reference fusion（三图参考融合生成）以及 video-input generation（视频输入生成）。用户可通过配置 prompt、image_urls、video_urls 等参数灵活控制输入源，同时支持 resolution（720p/1080p/4K）、duration（时长控制）、aspect_ratio（画面比例）等输出参数精细调节。任务采用异步提交机制，通过 task_id 进行状态轮询或配置 callback_url 实现 webhook 回调，适合集成到自动化生产管线中。
显著优点
1. 功能全面：覆盖当前主流AI视频生成场景，从纯文本到多模态融合，满足多样化创作需求。
2. 安全实践优秀：代码经过严格静态分析，无危险函数调用、硬编码密钥或恶意代码模式；API密钥通过环境变量安全传递，符合生产环境安全规范。
3. 依赖极简：零第三方依赖，仅使用系统标准工具 curl 和 bash，极大降低供应链攻击风险。
4. 官方API背书：直接调用 PoYo 官方服务端点，数据加密传输（TLS 1.2+），服务稳定性有保障。
5. 输出质量可控：支持最高4K分辨率输出，提供专业级的画面参数调节能力。
潜在缺点与局限性
1. 来源可信度限制：维护者为 ClawHub 平台个人开发者（coolhackboy），非知名组织或企业背景，长期维护能力和服务持续性存在不确定性。
2. 无客户端输入验证：脚本直接将 payload 传递给API，依赖服务端进行参数校验，错误反馈体验取决于 PoYo 服务端实现。
3. 异步任务复杂性：需要用户理解轮询机制或自行搭建 webhook 接收服务，对非技术用户有一定门槛。
4. 成本与配额依赖：实际使用受限于 PoYo 平台 API 配额和计费策略，技能本身不提供用量管理功能。
5. 平台锁定风险：深度绑定 PoYo 生态，未来若平台政策调整可能影响服务可用性。
适合的目标群体
- 内容创作者与短视频团队：需要快速生成高质量视频素材的自媒体、广告创意人员
- 开发者与MVP团队：希望将AI视频能力集成到产品中的技术团队，尤其是需要自动化视频生成管线的产品
- 设计师与视觉艺术家：探索AI辅助视频创作的创意工作者，需要参考图融合等高级功能
- 教育培训机构：制作教学视频、演示内容的从业者
使用风险与注意事项
1. API密钥安全：尽管技能本身安全处理密钥，但用户需确保 POYO_API_KEY 存储于服务器端环境变量，避免泄露到前端代码或版本控制系统。
2. 敏感内容风险：生成内容需符合 PoYo 平台使用政策，避免生成违规或侵权内容。
3. 数据隐私：上传的参考图片、视频及提示词将传输至 PoYo 服务端，涉及隐私或机密素材需谨慎评估。
4. 异步任务监控：生产环境建议配置 callback_url 替代轮询，避免资源浪费和任务状态延迟感知。
5. 网络超时处理：当前脚本未设置默认超时参数，高并发或网络波动场景下可能长时间挂起，建议按推荐增强超时配置。