PoYo Omni Flash 视频生成

PoYo 相关链接

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

本技能用于在 PoYo 上执行 Omni Flash 视频任务。它可协助智能体构建文本生成视频、图像生成视频、三图参考融合及视频输入类请求的有效载荷（payload），提交异步任务，并说明轮询（polling）或 Webhook 后续操作方式。

适用场景

• 用户明确提及 Omni Flash 或 omni-flash。
• 任务类型为文本生成视频、单图生成视频、三图参考融合，或视频输入生成。
• 工作流需调用 PoYo 的异步任务提交、任务状态轮询，或需提供回调 URL（callback URL）使用指引。

模型选择

• omni-flash：通过 PoYo 执行 Omni Flash 视频生成时使用。

关键输入参数

• prompt 是 input 内的必填字段。
• image_urls 为可选字段；若提供，则仅支持恰好一张图像或恰好三张图像。
• video_urls 为可选字段；最多支持一个视频 URL。
• resolution 为可选字段；取值需符合文档中定义的输出分辨率选项。
• duration 在 prompt 和 image 类工作流中为可选字段；当提供 video_urls 时，应省略该字段。
• aspect_ratio 为可选字段；取值需符合文档中定义的画面宽高比选项。
• callback_url 为可选字段；适用于生产环境中的队列化任务处理。

安全规范

• 将 POYO_API_KEY 视为机密信息（secret）。
• PoYo API 密钥应仅存储于服务端环境变量或后端密钥管理器中。
• 切勿将 API 密钥置于浏览器端代码、前端构建包、公开仓库、日志、截图或聊天输出中。
• 除非用户明确要求且已确认运行于安全的服务端环境，否则不得发起实时 API 调用。
• 除非用户信任 PoYo 及回调接收方，否则不得提交涉密源图像、私有视频、私有提示词（prompt）或私有回调 URL。

执行说明

• 请查阅 references/api.md 获取端点详情、模型 ID、通用字段、示例 payload 及轮询注意事项。
• 仅当用户希望从可信 Shell 环境中提交已准备好的 JSON payload 时，才使用 scripts/submit_omni_flash.sh。
• 若用户仅需 curl 示例命令，请基于 references/api.md 中的示例进行适配。
• 提交成功后，请清晰返回响应中的 task_id，以便后续轮询操作便捷执行。

输出预期

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

• 所选模型 ID
• 请求类型：文本生成视频、图像生成视频、参考融合，还是视频输入生成
• 最终提交的 payload，或简明的参数摘要
• 如适用，注明选定的 duration、resolution 和 aspect_ratio
• 是否涉及源图像或源视频
• 若实际提交了请求，则须返回响应中的 task_id
• 下一步操作：轮询任务状态，或等待 Webhook 回调