Public Figure Recognition (Public)
Updated at：2025-11-03
Function description
Public figure recognition
Request parameters
| Parameters | Required or not | Types | Description |
|---|---|---|---|
| max_face_num | No | uint32 | Maximum number of faces processed, defaulting to 1, maximum 5 |
| max_star_num | No | uint32 | Maximum number of similar celebrities per face, defaulting to 4 |
Response parameters
| Parameters | Subparameter | Subparameter | Types | Required | Description |
|---|---|---|---|---|---|
| log_id | - | - | uint64 | Yes | Log ID |
| result_num | - | - | uint32 | Yes | Actual number of faces detected (not exceeding max_face_num) |
| result | - | - | object[] | Yes | |
| - | location | - | object | Yes | Position of face in the input image |
| - | - | left | uint32 | Yes | Distance from face region to the left boundary |
| - | - | top | uint32 | Yes | Distance from face region to the upper boundary |
| - | - | width | uint32 | Yes | Width of face region |
| - | - | height | uint32 | Yes | Height of face region |
| - | stars | - | object[] | Yes | Public figure array |
| - | - | name | string | Yes | Name |
| - | - | star_id | string | Yes | Figure ID, globally unique |
| - | - | probability | float | Yes | Similarity, [0, 1] |
Response example
Plain Text
1 {
2 "log_id": 3268660173,
3 "result_num": 1,
4 "result": [
5 {
6 "location": {
7 "left": 132,
8 "top": 168,
9 "width": 238,
10 "height": 223
11 },
12 "stars": [
13 {
14 "name": "Zhang San",
15 "star_id": "515617",
16 "probability": 0.9750030040741
17 }
18 ]
19 }
20 ]
21 }