## 人臉識別  > 返回人臉識別年齡、性別、顏值、表情等各項參數。請求參數image請傳遞照片url。 ## 接口費用（ [點擊購買](https://market.topthink.com/product/214)） > 最低 0.002元/次 ## 接口調用（[調用須知](https://docs.topthink.com/think-api/1835086)） ### 請求地址 ``` GET https://api.topthink.com/ocr/face ``` ### 請求參數 | 名稱 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | appCode| string| 是|用戶授權碼，參考[API調用](https://docs.topthink.com/think-api/1835086) | | image| string | 是 | 圖片URL| ### 返回`data`參數 | 名稱 | 類型 | 示例值 | 說明 | | --- | --- | --- | --- | | location | array | | 人臉在圖片中的位置 | | face\_probability | int | 1 | 人臉置信度，代表這是一張人臉的概率，0最小、1最大 | | angle | array | | 人臉旋轉角度參數 | | age | int | 22 | 年齡 | | beauty | float | 72.72 | 顏值打分，范圍0-100，越大表示越美 | | expression | array | | 表情及可信度，0最小、1最大 | | face\_shape | array | | 臉型及可信度，0最小、1最大 | | gender | array | | 性別及可信度，0最小、1最大 | | glasses | array | | 是否帶眼鏡及可信度，0最小、1最大 | | race | array | | 人種及可信度，0最小、1最大 | | eye\_status | array | | 雙眼狀態（睜開/閉合）及可能性，越接近0閉合的可能性越大 | | emotion | array | | 情緒及可信度，0最小、1最大 | | face\_type | array | | 真實人臉/卡通人臉 | ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->ocrFace() ->withImage('https://docs.topthink.com/think-api/1835085') ->request(); ``` 返回示例： ~~~ { "code":0, "message": "成功", "data": [ { "location":{ "left":196.18, "top":162.42, "width":189, "height":186, "rotation":-2 }, "face_probability":1, "angle":{ "yaw":-0.18, "pitch":15.95, "roll":-4.14 }, "age":22, "beauty":72.72, "expression":{ "type":"smile", "probability":1 }, "face_shape":{ "type":"heart", "probability":0.54 }, "gender":{ "type":"female", "probability":1 }, "glasses":{ "type":"none", "probability":1 }, "race":{ "type":"yellow", "probability":1 }, "eye_status":{ "left_eye":1, "right_eye":1 }, "emotion":{ "type":"happy", "probability":1 }, "face_type":{ "type":"human", "probability":0.97 } } ] } ~~~