用途：这是一个返回用户品牌头像的服务端点，适用于新用户注册时立即需要头像、评论区或论坛默认头像、无上传照片的团队页/名录/排行榜、引导阶段的占位头像，也可作为 Gravatar / UI Avatars / DiceBear 的品牌化替代，以及演示环境的模拟数据。不适用于从单张照片深度伪造真人，也不应用于美化用户已上传的优质照片。
主要能力：可按种子（用户 ID、邮箱哈希、用户名或首字母）确定性生成头像，风格可选写实人像、插画（类似 Pixar/Disney）、扁平矢量、像素艺术、黏土拟态或字母组合，并使用品牌配色。核心是回退层级：真实照片→上传→按首字母 AI 生成→静态默认，按种子缓存，每位用户只付费一次。
使用方式：先确定回退层级与种子来源、风格、品牌配色、存储与缓存方案及回退顺序。通过 gen-ai 命令估算并验证模型，例如 gen-ai models info recraftv4、gen-ai pricing recraftv4，再用 gen-ai generate -m recraftv4 --aspect-ratio 1:1 --dry-run --debug 验证。把种子哈希为稳定属性，避免使用 Math.random() 或时间戳。生成示例：gen-ai generate -m recraftv4 -p "illustrated profile avatar..." --aspect-ratio 1:1 --negative-prompt "text, watermark, letters, realistic face, specific person" --save-to-drive --drive-folder avatars --json --no-input，用 jq 取 URL。缓存 URL 而非二进制，可按种子存入 Redis、KV、Postgres 或 S3；当生成不可用、限流或超预算时，返回基于同一色调的字母 SVG 兜底。可用 gen-ai batch run avatars-backfill.json -c 4 -o ./avatars-out 批量预热已有用户；批量失败可用 gen-ai batch resume <out> 重试。
适用场景与限制：插画/矢量头像推荐 recraftv4，写实通用人像用 flux-2-pro，像素风用 recraftv4 加像素提示，草稿用 gemini-3.1-flash-image，身份一致变体用 ideogram-character。需给提示模板加版本号（如缓存键 V=2）以便重新生成；必须始终保留字母 SVG 兜底，避免 UI 显示破损头像；在边缘按 IP 限流，防止机器人消耗额度；尊重用户已上传照片，不得覆盖；批量 500 张约 750–1000 积分、15–20 分钟；稳定后缓存命中率可超 99%，持续成本接近零。未提供具体价格与平台细节。