PoYo FLUX Dev 图像生成与编辑

PoYo 相关链接

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

本技能用于通过 PoYo 执行 FLUX Dev 相关任务。它可协助智能体构建文生图或单图编辑的请求载荷（payload），校验输出控制参数，提交异步任务，并说明轮询（polling）或 Webhook 后续操作流程。

适用场景

• 用户明确提及 PoYo、flux-dev 或 PoYo FLUX Dev API。
• 用户希望使用该 PoYo 模型进行文生图生成，或基于**唯一一张源图像**执行图像编辑。
• 当前工作流需构造 PoYo 请求载荷、提交异步任务、轮询任务状态，或需要回调（callback）机制指导。

模型选择

• flux-dev：同时支持文生图生成与单图编辑。
• 文生图时请**省略** input.image_urls；图像编辑时则**必须且仅能提供一个**源图像 URL。

关键输入参数

• input.prompt 为必填项。
• input.image_urls 为可选项；若提供，则必须且仅包含一个源图像 URL。
• input.size 可指定文档中定义的预设尺寸，或符合要求的自定义格式 WIDTHxHEIGHT（如 1024x1024）。
• input.n 控制所请求的输出图像数量（取决于当前服务是否支持该参数）。
• input.output_format 支持 png 或 jpeg 格式。
• callback_url 为可选项，适用于生产环境中的队列化处理。

安全规范

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

必需能力与权限边界

• Shell：仅允许在用户明确批准后，执行内置脚本 scripts/submit_flux_dev.sh。
• 网络：仅允许向 https://api.poyo.ai/api/generate/submit 发起 HTTPS 出站请求；仅当用户主动要求轮询某已返回的任务时，才可访问 https://api.poyo.ai/api/generate/status/{task_id}。
• 密钥：仅可从进程环境变量中读取 POYO_API_KEY，且仅将其作为 PoYo 请求的 Authorization 请求头发送。
• 文件系统：仅可读取用户显式指定的载荷 JSON 文件路径；该辅助脚本不会写入、删除、枚举或上传其他本地文件。
• 不得扩展目标端点、检查无关环境变量、启动后台进程，亦不可自动执行该辅助脚本。

执行流程

• 查阅 references/api.md 获取端点详情、请求字段定义、示例、响应结构及轮询说明。
• 仅当用户确认需从可信 Shell 提交已审阅的 JSON 载荷时，方可调用 scripts/submit_flux_dev.sh。
• 若用户仅需参考示例，请直接从 references/api.md 中选取并适配，**不发起真实请求**。
• 提交成功后，须清晰反馈返回的 task_id。

输出预期

在协助 FLUX Dev 相关任务时，输出内容应包含：

• 精确的模型 ID（即 flux-dev）
• 生成模式（text-to-image）或编辑模式（single-image editing）
• 最终请求载荷，或简洁明了的参数摘要
• 图像编辑时的源图像数量（应为 1）
• 选定的尺寸（size）、输出图像数量（n）及输出格式（output_format）
• 若已发起请求，则需包含返回的 task_id
• 后续步骤说明：轮询任务状态，或等待 Webhook 回调