PoYo Kling 2.6 视频生成

PoYo 相关链接

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

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

适用场景

• 用户明确提及 Kling 2.6、kling-2.6、原生音频视频、对话类视频，或 PoYo Kling 视频生成。
• 任务类型为文本生成视频、图像生成视频、短视频生成、产品宣传视频、社交媒体视频、讲解类视频，或含对话/音效的视频。
• 工作流需通过 PoYo 提交异步任务、轮询任务状态，或需配置回调 URL 指导。

模型选择

• kling-2.6：适用于 Kling 2.6 的文本生成视频或图像生成视频任务（支持可选原生音频）。

关键输入参数

• prompt 是 input 中的必填字段。
• sound 为可选字段，用于控制请求是否启用生成音频（取决于当前 PoYo 文档支持情况）。
• aspect_ratio 为可选字段，用于控制输出画面宽高比。
• duration 可设为 5 或 10 秒（以当前 PoYo 文档支持为准）。
• image_urls 为可选字段，当用户需要图像生成视频相关指导时使用。
• callback_url 为可选字段，适用于生产环境中的队列调度场景。

必需能力与权限边界

• Shell：仅在用户明确要求提交已审核载荷后，运行预置的辅助脚本。
• 网络：仅允许向 https://api.poyo.ai/api/generate/submit 发起 HTTPS 出站请求；仅当用户主动要求查询任务状态时，才可访问 PoYo 的任务状态端点。
• 密钥管理：仅从环境变量中读取 POYO_API_KEY，且仅将其作为 Authorization 请求头发送。
• 文件系统：仅可读取用户指定的载荷 JSON 文件路径；禁止写入、删除、枚举或上传任何无关本地文件。
• 不得检查无关环境变量、扩展端点范围、运行后台进程，或自动执行操作。

安全规范

• 将 POYO_API_KEY 视为敏感凭据，严格保护。
• PoYo API 密钥应存储于服务端环境变量或后端密钥管理器中。
• 切勿将 API 密钥置于浏览器端代码、前端构建包、公共代码仓库、日志、截图或聊天输出中。
• 除非用户明确要求且提供安全的服务端运行环境，否则不得发起实时 API 调用。
• 未经用户确认信任 PoYo 及回调接收方，不得提交含机密信息的 prompt、私有媒体 URL、私有 callback URL 或生成的媒体 URL。

执行流程

• 查阅 references/api.md 获取端点详情、模型 ID、通用字段、示例及轮询说明。
• 仅当用户希望从可信 Shell 环境中提交已准备好的 JSON 载荷时，使用 scripts/submit_kling_2_6.sh 脚本。
• 若用户仅需 curl 示例命令，请基于 references/api.md 中的样例进行适配。
• 提交完成后，清晰返回响应中的 task_id，便于后续轮询操作。

输出预期

在协助处理 Kling 2.6 相关任务时，输出内容应包含以下要素：

• 选定的模型 ID
• 请求类型（文本生成视频 或 图像生成视频）
• 最终请求载荷，或简明的参数摘要
• 所选的时长、宽高比及音频设置（如适用）
• 是否涉及源图像
• 若实际提交了请求，则返回 task_id
• 下一步操作建议：轮询任务状态 或 等待 Webhook 回调