核心用法
Beauty Generation API 是由 DiversityFaces.org 提供的 AI 人像生成服务，通过 RESTful API 实现高质量肖像图像的自动化生成。用户需通过 https://gen1.diversityfaces.org/api-key-request 获取 API 密钥（免费自动审批或捐赠 $5 获得 1000 次调用额度），随后在请求头中携带 X-API-Key 进行身份验证。
标准调用流程为四步：
1. 配额检查（GET /api/quota）：确认当日剩余调用次数，该操作不消耗配额；
2. 提交生成（POST /api/generate/custom）：携带英文提示词、尺寸参数（推荐 1536×1536）发起异步任务，返回 prompt_id；
3. 轮询状态（GET /api/status/{prompt_id}）：每 0.5-1 秒查询一次，直至状态为 completed；
4. 下载图像（GET /api/image/{filename}）：支持 WebP/PNG/JPEG 格式，典型总耗时 <10 秒。
显著优点
- 多样性覆盖：140+ 国籍、22 种肤色、22 种发型/发色、24 种场景背景、专业服饰选项，满足全球化与包容性需求；
- 生成速度：GPU 推理 1-2 秒，全流程 <10 秒，适合实时交互场景；
- 内容安全：内置安全过滤器，自动拦截未成年人、裸露、暴力、仇恨言论等违规请求；
- 成本友好：免费额度充足，捐赠模式透明（$5/1000 张），按日配额（默认 100 次/日）防止滥用；
- 格式灵活：支持多种输出格式与质量压缩调节；
- 脚本化友好：提供 Python/Bash 示例，便于用户封装为本地自动化工具，降低重复调用的 token 开销。
潜在缺点与局限性
- 异步架构依赖轮询：需客户端主动轮询状态，增加了实现复杂度（无 Webhook 机制）；
- 每日硬配额：免费用户单日上限 100 次，高频场景需等待次日或购买额外额度；
- 提示词语言限制：仅支持英文输入，非英语用户需额外翻译；
- API 密钥管理风险：密钥有效期 1 年，泄露后难以即时吊销，需用户自行保密；
- 服务商透明度：DiversityFaces.org 公开信息有限，企业级 SLA 与数据留存政策未明确披露；
- 内容过滤误杀：安全规则较严格，部分艺术化或边缘风格请求可能被误判拦截。
适合人群
- 游戏/影视从业者：快速生成角色概念图、NPC 头像、服装参考；
- 设计师与营销人员：批量制作多元化模特图、电商主图、广告素材；
- 开发者与创作者：集成至自动化工作流、头像生成器、社交媒体工具；
- 小型团队/个人：预算有限、对生成速度敏感、无需本地部署算力的用户。
常规风险
- 数据隐私：提示词与生成图像上传至第三方服务器（gen1.diversityfaces.org），敏感信息不应入 prompt；
- 版权与肖像权：生成图像虽为 AI 合成，但涉及真人风格时需注意使用场景合规，避免深度伪造争议；
- 服务连续性：项目处于早期开发阶段，API 端点可能变更，需关注更新；
- 配额耗尽导致的业务中断：生产环境需前置配额检查与优雅降级逻辑。