--- name: poyo-wan-2-7-image description: 通过 https://api.poyo.ai/api/generate/submit 在 PoYo / poyo.ai 上执行 Wan 2.7 图像生成与编辑；适用于 wan-2.7-image，支持文生图、基于一至四张参考图像的图像编辑、尺寸预设、自定义宽高对象、批量图像数量、指定 seed 输出、轮询（polling）及 Webhook 回调。 metadata: {"openclaw":{"homepage":"https://poyo.ai/models/wan-2-7-image","requires":{"bins":["curl"],"env":["POYO_API_KEY"]},"primaryEnv":"POYO_API_KEY"}}

PoYo Wan 2.7 图像生成与编辑

PoYo 相关链接

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

本技能用于在 PoYo 平台上提交 Wan 2.7 图像生成与图像编辑任务。它可协助智能体构建文生图或基于参考图像的编辑请求载荷（payload），异步提交任务，并说明后续轮询（polling）或 Webhook 回调机制。

适用场景

• 用户明确提及 Wan 2.7 Image、Wan 2.7 图像生成，或 wan-2.7-image。
• 任务类型为文生图、基于提示词的图像编辑、商品图变体生成、海报概念图生成、角色形象变体生成，或社交媒体配图生成。
• 工作流需调用 PoYo 异步任务提交接口、轮询任务状态，或需配置回调 URL（callback URL）指导。

模型选择

• wan-2.7-image：用于通过 PoYo 执行 Wan 2.7 的文生图与图像编辑任务。

关键输入参数

• prompt 是 input 中的必填字段。
• image_urls 为可选字段：文生图任务中请省略；图像编辑任务中可传入一至四张参考图像 URL。
• size 为可选字段，可使用文档中定义的尺寸预设字符串，也可传入自定义的宽高对象（如 {"width": 1024, "height": 1024}）。
• n 为可选字段，用于指定期望生成的图像数量。
• seed 为可选字段，适用于支持确定性输出的工作流。
• callback_url 为可选字段，适用于生产环境中的队列式任务处理。

安全规范

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

执行说明

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

输出预期

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

• 所选模型 ID
• 请求类型：文生图 或 图像编辑
• 最终请求载荷（payload）或简洁的参数摘要
• 所选尺寸及图像数量（如相关）
• 是否涉及参考图像
• 若已实际提交请求，则返回 task_id
• 下一步操作建议：轮询任务状态 或 等待 Webhook 回调