核心用法
本 Skill 是 PoYo Seedream 4 图像生成服务的官方 API 封装工具，专注于帮助开发者快速集成企业级图像生成能力。核心功能覆盖三大场景：纯文本生成（seedream-4）、参考图引导生成（带 image_urls 的 seedream-4）以及图像编辑（seedream-4-edit）。
使用时需配置 POYO_API_KEY 环境变量，通过 scripts/submit_seedream_4.sh 或自定义 curl 命令提交异步任务。请求体需包含必填字段 prompt，可选配置 size（控制宽高比）、resolution（1K/2K/4K 输出）、n（生成数量）及 callback_url（生产级 webhook 回调）。提交后返回 task_id，支持通过轮询或 webhook 获取最终结果。
显著优点
功能完整且专注：严格对齐 PoYo 官方 API 文档，覆盖文生图、图编辑、参考图引导、多分辨率输出（最高 4K）、异步状态轮询及 webhook 回调等全链路能力，无功能阉割。
安全架构清晰：API Key 强制从环境变量读取，无硬编码风险；代码层面无任何敏感信息泄露；依赖极简，仅使用系统原生 curl，无第三方包引入供应链攻击面。
生产级友好设计：内置 callback_url 支持事件驱动架构，避免轮询开销；异步任务模型适合高并发场景；返回 task_id 便于分布式系统追踪。
潜在缺点与局限性
来源可信度边界：维护者为个人开发者（coolhackboy），非知名组织或基金会背书，虽经安全扫描无恶意行为，但企业级用户需额外评估长期维护风险。
生态锁定：深度绑定 PoYo 平台，模型版本、定价策略、API 变更均受限于 PoYo 官方，跨平台迁移成本较高。
功能边界明确：仅支持 Seedream 4 系列模型，无法直接切换至其他图像生成服务（如 DALL-E、Midjourney API），也不提供图像后处理或存储管理功能。
异步复杂度：需自行实现状态轮询或 webhook 接收逻辑，对无后端经验的纯前端开发者存在集成门槛。
适合的目标群体
- 后端/全栈开发者：需要为产品快速接入企业级图像生成能力，重视代码透明度和安全合规
- AI 应用创业团队：基于 PoYo 生态构建文生图、图编辑产品原型或 MVP
- 运维/DevOps 工程师：需要标准化、无依赖的 Shell 脚本方案集成至 CI/CD 或自动化工作流
- 技术评估者：在正式采购 PoYo 企业服务前，需要安全可控的技术验证方案
使用风险
密钥泄露风险：若 POYO_API_KEY 配置不当（写入代码、日志、前端 bundle），将导致 API 额度被盗用或账户滥用。必须严格遵循"服务端环境变量或密钥管理系统"原则。
网络依赖与稳定性：服务可用性完全依赖 PoYo 平台，存在因对方服务降级、限流或区域性网络问题导致的任务失败风险。生产环境建议实现指数退避重试机制。
成本不可控：按量计费模式下，高分辨率（4K）、大批量（n 较大）或高频调用可能导致费用激增，需配合配额监控与告警。
隐私合规注意：虽然 Skill 本身符合 GDPR/CCPA（无持久化存储用户数据），但生成的图像内容及原始 prompt 仍流经 PoYo 服务端，涉及敏感内容（人脸、版权素材）时需确认 PoYo 数据处理协议（DPA）。