cURL 请求
POST /api/v1/image/profilecurl -X POST "https://avatarlookup.com/api/v1/image/profile" \
-H "X-API-Key: sk_your_api_key" \
-F "file=@avatar.jpg"接口约定
一次请求，立即返回
以 multipart 形式上传一张图片，字段名 file。鉴权使用你的 API Key。
复制下面的 curl 命令，只需将示例 API Key 替换为你自己的 Key。
响应
200 OK{
"code": 0,
"msg": "ok",
"data": {
"product": "image_profile",
"identifier": "img:7013df96c540904a4b7ba295e9162ab2",
"extra": {
"category": "individual portrait",
"gender": "male",
"age": "39",
"skin_color": "white",
"hair_color": "brown"
}
}
}正确使用结果
提交一张图片前要知道的三件事
提交的是图片本身
每次一张，用名为 file 的 multipart 文件字段提交。支持 JPEG、PNG、WebP、GIF，单张不超过 2 MB。整个过程没有手机号也没有邮箱 —— 结果描述的是这张图，不是某个账号。
先读 category
category 说明这是一张什么图。宠物、卡通、风景、物品同样能识别、同样计费，但结构上不会有年龄和性别 —— 那是结论，不是失败。
图片我方不保存
图片直接透传给识别服务，不落盘也不进对象存储。identifier 是按图片内容算出的指纹，同一张图恒定，可以拿它在你那侧做去重。
检测内容
图片画像识别 会返回什么？
返回字段
identifier· string — 提交图片的指纹，由图片内容算出。同一张图恒定是同一个值。extra.category· string — What the picture is: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar or object.extra.gender· string — male, female or unknown.extra.age· number — Estimated age, accurate to about 3 years and clamped to 0-80. Empty when no gender was determined — there is no placeholder number.extra.skin_color· string — Descriptive skin tone, for example white, east_asian or hispanic. Treat it as an open set.extra.hair_color· string — Descriptive hair colour, for example black, brown, blond or gray white. Treat it as an open set.
适用场景
在以下场景使用本产品
- 存量头像归档
- 人群画像
- 内容审核初筛
- 数据补全
直接答案
图片画像 是什么？
图片画像识别 返回 这张图片自身的属性：图片类型、性别、年龄估计、肤色与发色。用名为 file 的 multipart 文件字段向图片端点提交一张图，并在同一次 API 响应里读取 extra 对象。整个过程不涉及任何标识。
能力边界
不会返回哪些内容
- 它描述的是图片，不是人、也不是账号：结果里没有注册状态、可达性或身份归属这些含义。
- 年龄、性别、肤色、发色都是算法从单张图片上的估计。请只当作辅助信号 —— 不要用于身份认证、歧视性筛选或任何高风险决策。
- 图里没有人物同样会返回结果、同样计费。只有完全无法识别的图片才不计费。
产品常见问题
关于图片画像的常见问题
图片画像识别 返回什么？
在同一次同步响应中返回这张图片自身的属性：图片类型、性别、年龄估计、肤色与发色。
图片画像如何计费？
只要返回了结果就扣费，宠物、卡通、风景图也一样。只有完全无法识别的图片不计费。
支持哪些图片格式和大小？
JPEG、PNG、WebP、GIF，单张不超过 2 MB。类型按文件内容判定，不看扩展名。
图片会被保存吗？
不会。图片直接透传给识别服务，不落盘也不进对象存储，检测记录上只留按图片内容算出的指纹。
相关产品