--- name: poyo-kling-2-1 description: 通过 https://api.poyo.ai/api/generate/submit 在 PoYo / poyo.ai 上执行 Kling 2.1 图像生成视频任务；支持 kling-2.1/standard、kling-2.1/pro、起始帧引导视频生成、可选的 Pro 模式结束帧引导、时长设置、负向提示词、任务提交、轮询（polling）及 Webhook 回调。 metadata: {"openclaw":{"homepage":"https://poyo.ai/models/kling-2-1","requires":{"bins":["curl"],"env":["POYO_API_KEY"]},"primaryEnv":"POYO_API_KEY"}}

PoYo Kling 2.1 图像生成视频能力

PoYo 相关链接

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

本技能用于在 PoYo 平台上执行 Kling 2.1 图像生成视频任务。它可协助智能体构建 Standard 与 Pro 模式的请求载荷（payload），异步提交任务，并说明后续轮询或 Webhook 回调机制。

适用场景

• 用户明确提及 Kling 2.1、kling-2.1/standard、kling-2.1/pro 或 PoYo Kling 2.1 视频生成。
• 任务类型为起始帧图像生成视频，或 Pro 模式下的起始帧 + 结束帧联合引导视频生成。
• 工作流需调用 PoYo 异步任务提交接口、轮询任务状态，或配置回调 URL。

模型选择

• kling-2.1/standard：适用于仅由起始帧引导的图像生成视频任务。
• kling-2.1/pro：适用于起始帧引导的图像生成视频任务，并可选提供结束帧作为额外引导。

关键输入参数

• prompt 是 input 对象中的必填字段。
• start_image_url 对 Standard 和 Pro 模式均为必填项。
• duration 可设为 5 或 10（单位：秒）。
• end_image_url 为可选字段，仅 kling-2.1/pro 支持。
• negative_prompt 为可选字段，用于排除不期望的视觉特征。
• callback_url 为可选字段，适用于生产环境中的队列式任务处理。

安全规范

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

执行方式

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

输出预期

在协助用户完成 Kling 2.1 相关任务时，输出内容应包含以下要素：

• 选定的模型 ID
• 明确说明选用的是 Standard 还是 Pro 模式
• 最终提交的 payload 内容，或简洁的参数摘要
• 如涉及，注明所选时长与负向提示词
• 是否启用了结束帧引导
• 若实际执行了请求，需返回响应中的 task_id
• 下一步操作指引：轮询任务状态，或等待 Webhook 回调