核心用法
Beauty Generation API 是一个基于 AI 的人像图像生成服务，需通过 BEAUTY_API_KEY 环境变量配置用户自有 API 密钥。用户需先访问官网申请 API Key（$5 捐赠换取 1000 次调用额度），随后通过三步流程生成图像：① 调用 /api/quota 查询每日限额（不消耗额度）；② 向 /api/generate/custom 提交英文描述提示词，获取 prompt_id；③ 轮询 /api/status/<prompt_id> 直至状态为 completed，最后通过 /api/image/<filename> 下载图像。支持自定义分辨率（256-2048px，8的倍数）、多种输出格式（WebP/PNG/JPEG）及质量参数。
显著优点
- 生成速度快：GPU 推理仅需 1-2 秒，全流程通常 <10 秒
- 多样性支持：涵盖 140+ 国籍、8 种风格、24 种表情、22 种发型与肤色、24 种场景背景
- 内容安全内置：主动过滤未成年人、裸露、暴力、仇恨言论等违规内容
- 配额透明：每日限额机制明确，支持实时查询剩余调用次数
- 异步处理：队列化任务管理，避免阻塞等待
潜在局限与风险
- 商业成本：基础使用需捐赠 $5 获取 API Key，非完全免费服务
- 额度限制：默认每日 100 次调用上限，高频使用需跨日或购买多 Key
- 隐私顾虑：用户提示词需发送至
gen1.diversityfaces.org云端处理，存在数据外泄风险 - 依赖外部服务：服务可用性受制于第三方基础设施，文档标注为"早期开发阶段"，API 可能变更
- 无本地运行：必须联网，无法离线部署
- 内容误判：内置安全过滤器可能过度拦截艺术创作中的边缘题材
适合人群
- 游戏开发者与角色设计师（快速生成多样化角色原型）
- 内容创作者与营销人员（制作头像、虚拟形象、时尚可视化素材）
- 需要专业头像的远程工作者与自由职业者
- 注重文化多样性与包容性代表的项目团队
常规风险提醒
- API Key 泄露风险：密钥与额度直接挂钩，一旦泄露可能导致额度被恶意耗尽
- 合规责任：用户需自行确保生成内容符合当地法律法规，平台仅提供技术工具
- 服务持续性：早期开发阶段项目，长期维护与商业模式稳定性存疑
- 数据跨境：服务由 diversityfaces.org 提供，用户数据可能涉及跨境传输