随机头像

上新

随机头像:按性别、风格、数量生成 DiceBear 风格化头像直链

随机头像:基于 DiceBear 风格化头像库,按性别、风格、数量生成可直链的图片地址(PNG/SVG 等)。
无需自备图库;同一 seed + style 可复现同一头像。

说明:DiceBear 无原生性别开关,角色类风格通过发型/胡须等特征倾向近似男/女;机器人、抽象类风格不受 gender 影响。

调用地址:https://api.ynlskj.com.cn/gateway/avatar

请求方法:POST

在其他地方怎么调用

  1. 请求地址用上面的调用地址,把 JSON 放在请求体里
  2. 方法用 POST
  3. API Key 只能放在请求头 X-API-Key,不要写进网址,也不要写进 Query 框
  4. Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key

参数说明

参数位置必填说明
genderBody JSON性别倾向:male / female / all(默认)。也可用 男 / 女 / 不限,或 sex
styleBody JSON头像风格,默认 avataaars。传 random 随机选一种。常用:pixel-art、bottts、lorelei、adventurer。完整列表见返回 data.styles
countBody JSON一次生成条数,1–10,默认 1。超过会返回错误
sizeBody JSON边长像素,32–512,默认 128
formatBody JSON图片格式:svg(默认,限流更宽)/ png / webp / jpg。批量建议用 svg
seedBody JSON种子。相同 seed+style 得到同一头像;批量时自动追加 -1、-2…
X-API-KeyHeader你的 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 调整胡须等特征。

返回说明

字段说明
retok 成功,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","…"]}}

在线调试

登录后可在线调试。调试会真实调用网关并消耗次数。

去登录