大資料圖像分析-面相分析

文件說明

        利用大資料，對面相五官特徵點進行分析，結合《麻衣相術》《柳莊相法》對運勢進行推斷，成功率較高。該API識別成功率很高，請放心使用。

快取說明

        為提升API 回應速度並降低重複計算成本，本API對 image_url 結果進行短期快取優化。相同 image_url 在快取有效期內（約5分鐘）將返回相同結果，快取機制用於性能優化，不影響最終結果一致性，快取時間可能根據系統負載進行動態調整。

請求方式

POST GET 

https://api.yuanfenju.com/index.php/v1/Dashuju/mianxiang

請求標頭 (Headers)

欄位 型別 描述
Content-Type String application/x-www-form-urlencoded

請求參數

欄位 型別 描述
api_key String 存取金鑰 (API Key)
image_url String 圖像網址，在公網可以訪問的連結，例：https://www.abc.com/abc.jpg
【格式限制】支援 PNG、JPG、JPEG、BMP，不支援 GIF。尺寸建議 1920x1080 以下，檔案大小不可超過 2MB。
【儲存與頻寬要求】伺服器下載逾時上限為 8 秒，請依圖片託管方式配置：
1. 推薦方案（無需擔心頻寬）：使用阿里雲 OSS、騰訊雲 COS 等物件儲存服務（或搭配 CDN），雲端具備超大頻寬出口，可直接穩定秒級讀取。
2. 自建伺服器方案：若使用自家主機直接作為圖源，該伺服器對外頻寬需 ≥3Mbps（建議 ≥5Mbps），嚴禁使用 1Mbps 等低頻寬伺服器，否則極易觸發 8 秒下載逾時錯誤。
liveness String 活體控制，檢測結果中不符合要求的人臉會被過濾
非必須參數 例：
NONE: 不進行控制
LOW:較低的活體要求
NORMAL：一般的活體要求
HIGH：較高的活體要求
如果不傳遞該參數預設為 NONE
bd_appid String 百度智能雲應用的AppID
選填，如果不傳，程序會優先選擇商戶後臺設定的百度智能雲應用的AppID
如果商戶也沒設定，則選擇公用APPID，但公用設定每秒使用次數會受到限制(< 1QPS)
點擊此處了解如何獲取百度智能雲APPID
bd_apikey String 百度智能雲應用的APIKey
選填，如果不傳，程序會優先選擇商戶後臺設定的百度智能雲應用的APIKey
如果商戶也沒設定，則選擇公用APIKey，但公用設定每秒使用次數會受到限制(< 1QPS)
點擊此處了解如何獲取百度智能雲APIKey
bd_secretkey String 百度智能雲應用的SecretKey
選填，如果不傳，程序會優先選擇商戶後臺設定的百度智能雲應用的SecretKey
如果商戶也沒設定，則選擇公用SecretKey，但公用設定每秒使用次數會受到限制(< 1QPS)
點擊此處了解如何獲取百度智能雲SecretKey
lang String 多語言：zh-cn 、zh-tw     
選填，如果不傳遞這個參數，預設為 zh-cn

請求參數範例

$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'image_url' => 'https://www.abc.com/abc.jpg',
'liveness' => 'NORMAL'
'bd_appid' => '******',
'bd_apikey' => '******',
'bd_secretkey' => '******',
];

回傳參數

欄位 型別 描述
errcode String 狀態碼 0成功 其它為失敗
errmsg String 狀態碼說明
notice String 聲明
data Json 資料內容

成功回傳範例

{
      "errcode": 0,
      "errmsg": "請求成功",
      "notice":"本次測算結果僅供娛樂使用，請勿用於封建迷信和違法用途。",
      "data": {
            "face_type": "human", //human: 真實人臉 cartoon: 卡通人臉
            "age": 22,             //年齡
            "beauty": 74,           //顏值評分
            "beauty_desc": "你的顏值超過了全國的74%的人！", //顏值描述
            "expression": "none", //表情 none:不笑；smile:微笑；laugh:大笑
            "gender": "female",  //male:男性 female:女性
            "face_shape": "瓜子臉", //臉型
            "face_shape_desc": "《柳莊相法》有雲，面相有清濁，運勢各不同，人為萬物之靈用長，秉彜其中、有貴賤......",//臉型描述
            "face_shape_score": "18",  //臉型評分
            "eyebrow_shape": "平眉",  //眉型
            "eyebrow_shape_desc": "《麻衣相術》有雲，眉為保壽官，也稱為情緣宮，眉形好，則行運貴人幫扶而身......",//眉型描述
            "eyebrow_shape_score": "18",//眉型評分
            "eye_shape": "柳葉眼", //眼型
            "eye_shape_desc": "《麻衣相術》有雲，眼為監察官，眼形好，則聰慧篤定而清貴；柳葉眼是一種相對罕......", //眼型描述
            "eye_shape_score": "16", //眼型評分
            "nose_shape": "伏犀鼻",    //鼻型
            "nose_shape_desc": "《麻衣相術》有雲，鼻為審辯宮，鼻形好，則處世通達而多成；伏犀鼻插天庭中......", //鼻型描述
            "nose_shape_score": "20",  //鼻型評分
            "mouth_shape": "龍口唇",  //嘴型
            "mouth_shape_desc": "《麻衣相術》有雲，口為出納官，口形好，則食祿頗豐而善辯；面相中的龍口......", //嘴型描述
            "mouth_shape_score": "18",  //嘴型評分
            "mianxiang_total_score": 90, //面相總分
            "mianxiang_overview_desc": "你的上庭柔和，是個低調好青年~只是在愛情中容易受到家庭影響常......", //面相概述
            "mianxiang_five": "火",  //面相五行
            "mianxiang_five_simple_desc": "熱情有禮", //面相五行簡述
            "mianxiang_five_detail_desc": "您的臉型屬於火型臉，您在性格的表現上會比較急躁，但如果......", //面相五行詳述
            "mianxiang_further_30": "0-30歲智力高，比同齡人聰明反應較快，能得到長輩的賞識，知所進......", //0-30而立之年運勢
            "mianxiang_further_40": "31-40歲比較順利，桃花也不錯，在貴人運上也能遇到貴人相助，做......", //31-40不惑之年運勢
            "mianxiang_further_50": "41-50歲是財運的爆發期，會感覺到事業發展前所未有的好，賺錢變......", //41-50知命之年運勢
            "mianxiang_further_60": "51-60歲是你一個情感的重心期，這時候你會感覺到自己的情緒特別......" //51-60花甲之年運勢
      }
    }
 }

失敗回傳範例

{
  "errcode": -1,
  "errmsg": "日期有誤",
}
導覽目錄