dicebear

传个种子参数，秒出风格统一的用户头像

开源 🏷️基础免费，高级付费 ⏳ 访问状态待核验设计创意 🍴 复刻 435 🐛 待处理 7 👀 关注 29

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 9941

维护状态活跃

是否开源开源

定价模式 🏷️基础免费，高级付费支持限时试用 · 开源库免费，官网提供在线头像生成与API，高级功能或商用授权可能付费

项目预览

项目数据

分类设计创意

开发团队dicebear

官网地址https://www.dicebear.com

GitHubhttps://github.com/dicebear/dicebear

定价模式🏷️基础免费，高级付费

价格说明开源库免费，官网提供在线头像生成与API，高级功能或商用授权可能付费

访问状态⏳ 访问状态待核验

是否开源是

开源协议MIT

主要语言Vue

技术栈/模型api,avataaars,avatar,avatar-placeholder,avatars,bottts,dicebear,figma,pixel-art

GitHub 星标★ 9941

上线时间2017-03-21 00:00:00

代码更新2026-10-21

仓库体积32.4 MB

本站数据更新2026-10-28

维护状态活跃

收录时间2026-10-28

浏览次数0

项目介绍

DiceBear 是一个面向设计师和开发者的头像生成库，核心价值在于把「用户头像」这件事从依赖上传图片变成按需程序化生成。它内置 avataaars、bottts、pixel-art 等多种风格，通过统一的 HTTP API 和 JavaScript 库调用，传入 seed 等参数即可稳定输出同一用户的确定性头像，保证同一标识始终得到相同图像。项目提供可自托管的服务端方案，也支持在 Figma 等设计工具中使用，方便团队把头像风格统一到产品视觉体系里。对没有真实头像的用户、评论列表、协作工具成员标识等场景，它能避免灰色占位图和版权图片问题，减少存储与审核成本。技术上以 Vue 构建文档与示例站点，API 设计简洁，风格包可独立选用，适合前端快速接入或后端批量生成。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-10-28 · 当前星标 ★ 9941

技术标签

api avatar pixel-art

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：库/依赖 5 步

环境要求

已安装 Node.js 与 npm（用于安装 @dicebear/core）
可正常访问 npm 包仓库
项目中使用 JavaScript/TypeScript，或按官网表格选择其他语言端口
可访问 dicebear.com 查看文档与 Playground 示例

安装与启动步骤

1了解生成规则

DiceBear 把 seed 字符串（用户名、邮箱等）确定性映射为 63 种风格之一的 SVG 头像，同一 seed 永远得到同一张图，无需用户上传图片。
2创建项目目录

新建一个空目录并初始化 npm 项目，作为安装头像库的载体工程。
```
mkdir dicebear-demo
cd dicebear-demo
npm init -y
```
3安装核心库

安装 README 中列出的 JavaScript/TypeScript 核心包，安装完成后即可在代码中引用。
```
npm install @dicebear/core
```
4按文档接入生成

参照官方文档传入 seed 与风格选项（颜色、背景、旋转、发型或眼镜等单项特征），生成并保存 SVG 输出。
5预览与核对效果

在 Playground 输入同一 seed 对照风格效果，确认同一标识每次生成的头像一致。

关键配置

配置项	必填	说明	示例
`seed`	是	种子字符串，决定头像内容，同一值恒定输出同一张图	`user@example.com`
`style`	是	头像风格，内置 63 种，如 avataaars、bottts、pixel-art	`bottts`
`backgroundColor`	否	背景色等风格选项，用于统一产品视觉	`#ffffff`