核心用法
PoYo GPT-4o Image 技能用于将用户请求转化为符合 PoYo API 规范的图像生成或编辑任务。核心工作流包括：选择模型（gpt-4o-image 用于生成，gpt-4o-image-edit 用于编辑）、构建 POST 请求体至 https://api.poyo.ai/api/generate/submit、使用 Bearer Token 认证、保存返回的 task_id 并进行状态轮询或等待 webhook 回调。
必需字段：model（顶层）、input.prompt（除非用户已提供完整 payload）；可选字段包括 input.image_urls（参考图）、input.size（画布尺寸）。执行时建议查阅 references/api.md 获取端点详情与示例，或使用 scripts/submit_gpt_4o_image.sh 脚本直接提交。
显著优点
- 成本优势：PoYo 平台声称价格比官方低约 80%，适合高频调用场景
- 模型完整：覆盖 GPT-4o 图像生成与编辑双能力
- 标准接口：RESTful API 设计，Bearer 认证机制通用易懂
- 异步架构：支持任务 ID 追踪与 webhook 回调，便于集成到生产流水线
潜在缺点与局限性
- 第三方依赖：非官方 OpenAI 服务，存在平台稳定性与政策变更风险
- 文档深度：实际效果、速率限制、内容过滤策略未在技能文档中详述
- 调试成本：异步轮询模式增加客户端复杂度，失败任务需额外处理逻辑
- 合规灰区：官方 API 的聚合代理模式可能触及服务条款边界，需自行评估
适合人群
- 需要批量生成/编辑图像但预算敏感的开发者与中小企业
- 已将 PoYo 纳入技术栈、希望统一多模型（图像/视频/音乐/对话）调用渠道的团队
- 能接受第三方平台风险、具备 API 集成与异步任务处理能力的工程团队
常规风险
| 风险类型 | 说明 |
|---------|------|
| 密钥泄露 | `POYO_API_KEY` 需妥善保管，避免硬编码或日志暴露 |
| 供应链安全 | 第三方平台存在跑路、调价、服务中断可能，建议设置熔断与备选方案 |
| 内容合规 | 图像生成类模型存在版权、肖像权及有害内容输出风险，需前置过滤与人工审核 |
| 成本失控 | 高频调用场景下若无配额监控，可能造成意外账单 |
| 数据隐私 | 上传至第三方平台的参考图像可能涉及敏感信息，需确认 PoYo 数据处理协议 |
安全等级说明：因未执行实际安全扫描，基于第三方代理模式与密钥依赖特性，给予 A 级评估——功能可用但需额外风控措施。