核心用法
PoYo Flux 2 技能封装了 PoYo AI 平台的 Flux 2 图像生成 API，提供标准化的作业提交与状态追踪能力。用户通过 https://api.poyo.ai/api/generate/submit 端点提交任务，支持四种模型变体：
- flux-2-pro：高质量商业级图像生成
- flux-2-pro-edit：基于参考图像的精细编辑
- flux-2-flex：平衡质量与成本的通用生成
- flux-2-flex-edit：轻量级图像编辑方案
请求需包含 model 顶层字段、input.prompt 文本描述，可选配置 input.size（画布比例）、input.resolution（质量档位）及 input.image_urls（参考图）。认证采用 Bearer Token 模式，依赖环境变量 POYO_API_KEY。
显著优点
- 模型覆盖完整：原生支持 Flux 2 全系模型，区分生成与编辑场景
- 工作流标准化：统一的任务提交-轮询-回调机制，降低集成复杂度
- 参数灵活：分辨率与尺寸独立配置，适应多样化输出需求
- 辅助工具完备：提供
references/api.md文档与scripts/submit_flux_2.sh脚本
潜在局限
- 外部依赖单一：完全绑定 PoYo 平台可用性与定价策略
- 异步处理必需：需自行实现轮询或 webhook 接收逻辑
- 编辑场景受限：
image_urls参数仅限编辑类模型，误用导致失败 - 成本控制隐含：pro/flex 档次差异显著，需用户主动权衡
适合人群
- 需要 Flux 2 模型能力的开发者与创意工作者
- 已采纳 PoYo AI 生态或愿意接受 vendor lock-in 的团队
- 具备异步任务处理经验、能管理 API 密钥安全的技术用户
常规风险
- 密钥泄露：
POYO_API_KEY若硬编码或误提交至版本控制，可能导致额度盗刷 - 任务状态丢失：未妥善保存
task_id或轮询逻辑缺陷将导致结果无法回收 - 内容合规：生成内容受 PoYo 平台审核策略约束，存在拒绝服务可能
- 成本累积：高分辨率 + pro 模型组合易产生意外费用，建议前置预算校验