DiceBear: 开源头像库与 API
什么是 DiceBear?
使用 DiceBear,你可以在很短时间内为你的项目创建很棒的头像。 无论你是在寻找抽象图形,还是精心设计的角色,你 都能在我们的头像风格中找到合适的选择。无论你想如何以及 用于何处,DiceBear 都能提供合适的解决方案!
除了纯随机头像之外,你还可以为用户身份创建 确定性 头像。 借助内置的 PRNG,你可以根据 seed 一次又一次地生成相同的头像。 当然也可以创建个性化头像!只需使用每种头像风格提供的无数选项即可。
并且多亏了 JavaScript 库, PHP 库, Python 库, Rust 库, Go 库, HTTP API, CLI, Figma 插件, 编辑器 和 Playground,你的下一个 头像总是近在咫尺!探索我们的 头像 API,即可通过简单的基于 URL 的集成来使用。
如何使用?
HTTP API
使用一个简单的 URL 即可在任何语言或平台中嵌入头像,而无需安装任何东西。
JS 库
在浏览器或 Node.js 中生成头像,完整支持 TypeScript。非常适合 React、Vue、Svelte 等。
PHP 库
使用 PHP 8.2+ 在服务器上生成头像。与 JS 库的 API 完全一致:相同的 seed,相同的结果。
Python 库
使用 Python 3.10+ 在服务器上生成头像。与 JS 库的 API 完全一致:相同的 seed,相同的结果。
Rust 库
使用 Rust 1.80+ 在服务器上生成头像。与 JS 库的 API 完全一致:相同的 seed,相同的结果。
Go 库
使用 Go 1.23+ 在服务器上生成头像。与 JS 库的 API 完全一致:相同的 seed,相同的结果。
CLI
非常适合从命令行直接进行多种图片格式的自动化和批量导出。
编辑器
使用交互式编辑器浏览所有头像风格,自定义选项,并且无需编写任何代码即可导出头像。
它是如何工作的?
这些头像以 SVG 格式创建。 这使得无需太多计算资源即可动态生成头像。在大多数情况下, 会从一组 SVG 元素中选择各种元素,例如头发、眼睛、耳朵等,并将它们组合起来创建一个角色 / 头像。
FNV-1a 结合 Mulberry32 被用作 PRNG 的算法。该 PRNG 不会尝试成为 加密安全的。
设计即隐私
DiceBear 在构建时就考虑到了隐私。当使用 JavaScript 库, PHP 库, Python 库, Rust 库 或 Go 库 时,头像会完全在你的 基础设施上生成。任何个人数据都不会离开你的系统。对于需要 完全控制数据保留和基础设施的团队,DiceBear 可以 self-hosted,因此不依赖 外部服务。