PoYo FLUX Schnell 图像生成

PoYo 相关链接

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

本技能用于通过 PoYo 执行 FLUX Schnell 文本到图像（text-to-image）任务。它可协助智能体构建基于提示词的请求载荷、校验输出控制参数、提交异步任务，并说明轮询（polling）或 Webhook 后续操作流程。

适用场景

• 用户明确要求使用 PoYo、flux-schnell 或 PoYo FLUX Schnell API。
• 用户希望使用该 PoYo 模型进行纯文本到图像的生成，且无需提供源图像。
• 当前工作流需要构造 PoYo 请求载荷、提交异步任务、轮询任务状态，或需 Webhook 回调相关指导。

不适用场景

• 请求涉及图像编辑、图像到图像（image-to-image）转换，或需参考图像输入；此时应改用明确声明支持 image_urls 参数的 PoYo 模型。

模型选择

• flux-schnell：仅支持文本到图像生成。
• 请勿包含 input.image_urls 字段；当前 PoYo 的参数校验逻辑会拒绝为此模型提供图像输入。

关键输入参数

• input.prompt 为必填项。
• input.size 控制预设尺寸或指定受支持的自定义尺寸格式 WIDTHxHEIGHT。
• input.n 控制所请求的输出图像数量（取决于当前服务是否支持该参数）。
• input.output_format 支持 png 或 jpeg。
• callback_url 为可选参数，适用于生产环境中的队列式处理场景。

安全规范

• 将 POYO_API_KEY 视为敏感凭据，仅存储于服务端环境变量或密钥管理器中。
• 切勿将 API 密钥置于浏览器端代码、前端构建产物、公开代码仓库、日志、截图或聊天输出中。
• 除非用户明确信任 PoYo 及回调接收方，否则不得提交含机密信息的提示词或私有回调 URL。
• 除非用户明确发起请求，且已确保运行于安全的服务端环境中，否则不得执行真实 API 调用。

必需能力与权限边界

• Shell：仅可在用户明确批准后，运行已打包的辅助脚本 scripts/submit_flux_schnell.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_schnell.sh。
• 若用户仅需示例，可直接基于 references/api.md 中的样例进行调整，无需发起真实请求。
• 提交成功后，须清晰反馈返回的 task_id。

输出预期

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

• 精确的模型 ID
• 确认该请求为文本到图像类型
• 最终请求载荷，或简洁的参数摘要
• 选定的图像尺寸、输出数量及输出格式
• 如已提交请求，则返回对应的 task_id
• 后续步骤说明：轮询任务状态，或等待 Webhook 回调