--- name: poyo-flux-2 description: 通过 https://api.poyo.ai/api/generate/submit 接口使用 PoYo AI Flux 2。当用户希望使用该模型族生成或编辑媒体内容、准备兼容 PoYo 的请求载荷（payload）、提交任务，或轮询 flux-2-pro、flux-2-pro-edit、flux-2-flex、flux-2-flex-edit 等任务状态时使用。 metadata: {"openclaw": {"homepage":"https://poyo.ai/models/flux-2", "requires": {"bins": ["curl"], "env": ["POYO_API_KEY"]}, "primaryEnv": "POYO_API_KEY"}}

PoYo Flux 2

PoYo 相关链接

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

使用本技能提交并跟踪 Flux 2 模型族的相关任务。

快速工作流

1. 根据所需输出选择合适的模型 ID。
2. 构建向 POST https://api.poyo.ai/api/generate/submit 发送的请求体。
3. 以 Bearer 认证方式发送 JSON 请求，请求头中包含 Authorization: Bearer 。
4. 保存响应中返回的 task_id。
5. 轮询统一任务状态接口，或等待 callback_url 发送的 Webhook 通知。

请求规则

• 必须在顶层指定 model 字段。
• 提示词（prompt）应具体明确，并聚焦于预期结果。
• 除非用户已提供完整载荷（full payload），否则必须提供 input.prompt。
• 仅当任务需要参考图或源图像时，才使用 input.image_urls。
• 使用 input.size 匹配目标宽高比或画布尺寸。
• 当需权衡图像质量与成本时，使用 input.resolution。

模型选择

flux-2-pro

适用于对质量要求更高或属于高级别（premium）的任务。

flux-2-pro-edit

适用于编辑或修改已提供的图像。

flux-2-flex

适用于基于该模型变体的一般性图像生成任务。

flux-2-flex-edit

适用于编辑或修改已提供的图像。

执行说明

• 查阅 references/api.md 获取接口详情、模型 ID、关键字段、示例载荷及轮询注意事项。
• 使用 scripts/submit_flux_2.sh 脚本从 Shell 提交原始 JSON 载荷。
• 若用户仅需 curl 示例，请直接适配 references/api.md 中的示例，无需重新编写。
• 提交成功后，请清晰反馈返回的 task_id，以便后续轮询操作顺利进行。

输出预期

在协助处理该模型族相关任务时，请包含以下信息：

• 选定的模型 ID
• 最终请求载荷，或简洁的参数摘要
• 是否涉及参考图像
• 若已实际提交请求，则需提供返回的 task_id
• 下一步操作：轮询任务状态，或等待 Webhook 通知

备注：

需从 https://poyo.ai 获取 POYO_API_KEY。