随机头像
上新随机头像:按性别、风格、数量生成 DiceBear 风格化头像直链
随机头像:基于 DiceBear 风格化头像库,按性别、风格、数量生成可直链的图片地址(PNG/SVG 等)。
无需自备图库;同一 seed + style 可复现同一头像。
说明:DiceBear 无原生性别开关,角色类风格通过发型/胡须等特征倾向近似男/女;机器人、抽象类风格不受 gender 影响。
无需自备图库;同一 seed + style 可复现同一头像。
说明:DiceBear 无原生性别开关,角色类风格通过发型/胡须等特征倾向近似男/女;机器人、抽象类风格不受 gender 影响。
调用地址:https://api.ynlskj.com.cn/gateway/avatar
请求方法:POST
在其他地方怎么调用
- 请求地址用上面的调用地址,把 JSON 放在请求体里
- 方法用
POST - API Key 只能放在请求头
X-API-Key,不要写进网址,也不要写进 Query 框 - Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
gender | Body JSON | 否 | 性别倾向:male / female / all(默认)。也可用 男 / 女 / 不限,或 sex |
style | Body JSON | 否 | 头像风格,默认 avataaars。传 random 随机选一种。常用:pixel-art、bottts、lorelei、adventurer。完整列表见返回 data.styles |
count | Body JSON | 否 | 一次生成条数,1–10,默认 1。超过会返回错误 |
size | Body JSON | 否 | 边长像素,32–512,默认 128 |
format | Body JSON | 否 | 图片格式:svg(默认,限流更宽)/ png / webp / jpg。批量建议用 svg |
seed | Body JSON | 否 | 种子。相同 seed+style 得到同一头像;批量时自动追加 -1、-2… |
X-API-Key | Header | 是 | 你的 API Key |
请求示例
| 场景 | Body 示例 |
|---|---|
| 默认一个 | {} 或不传参数 |
| 女性卡通头像 | {"gender":"female","style":"avataaars","count":3} |
| 男性像素风 | {"gender":"male","style":"pixel-art","size":256} |
| 随机风格 | {"style":"random","format":"svg"} |
| 超量(会报错) | {"count":11} → count 最多 10 |
返回的 url 可直接用于 <img>;图片由 DiceBear CDN 提供。默认 format=svg;单次最多 10 张。默认锁定微笑五官,并按 gender 调整胡须等特征。
返回说明
| 字段 | 说明 |
|---|---|
ret | ok 成功,err 失败 |
data.url | 第一个头像的直链(便于 count=1 时直接取用) |
data.style / data.gender / data.seed | 实际风格、性别倾向、种子 |
data.format / data.size | 图片格式与边长 |
data.avatars | 全部结果数组。每项含 url、style、gender、seed、format、size、gender_applied |
data.styles | 当前支持的全部风格名列表 |
msg | 本站提示,如「次数充足,剩余 99 次」或「次数不足,剩余 0 次」 |
remain_quota | 本次调用后的剩余次数 |
可直接复制的代码
未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key,不会展示别人的。
<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/avatar');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{
"gender": "female",
"style": "avataaars",
"count": 2,
"size": 128,
"format": "png"
}',
]);
echo curl_exec($ch);
请求参数演示
{"gender":"female","style":"avataaars","count":2,"size":128,"format":"png"}
响应演示
{"ret":"ok","data":{"url":"https://api.dicebear.com/9.x/avataaars/png?seed=demo-female-01&size=128&facialHairProbability=0&beardProbability=0","style":"avataaars","gender":"female","seed":"demo-female-01","format":"png","size":128,"count":2,"avatars":[{"url":"https://api.dicebear.com/9.x/avataaars/png?seed=demo-female-01&size=128&facialHairProbability=0&beardProbability=0","style":"avataaars","gender":"female","seed":"demo-female-01","format":"png","size":128,"gender_applied":true},{"url":"https://api.dicebear.com/9.x/avataaars/png?seed=demo-female-02&size=128&facialHairProbability=0&beardProbability=0","style":"avataaars","gender":"female","seed":"demo-female-02","format":"png","size":128,"gender_applied":true}],"styles":["adventurer","avataaars","bottts","pixel-art","lorelei","…"]}}