PHPackages weiwei2012holy/faceplusplus - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. weiwei2012holy/faceplusplus ActiveLibrary[API Development](/categories/api) weiwei2012holy/faceplusplus =========================== face++ api 1779PHP Since Jan 8Pushed 7y ago1 watchersCompare [ Source](https://github.com/weiwei2012holy/faceplusplus)[ Packagist](https://packagist.org/packages/weiwei2012holy/faceplusplus)[ RSS](/packages/weiwei2012holy-faceplusplus/feed)WikiDiscussions master Synced 3d ago READMEChangelogDependenciesVersions (1)Used By (0) Face++ 接口集合,待完善版本 ----------------- [](#face-接口集合待完善版本) #### 1.安装 [](#1安装) ``` composer require weiwei2012holy/faceplusplus ``` #### 2.使用 [](#2使用) ``` $key = '8kG5rX3D1mbK*********VWQEuFuhr8L'; $secret = 'XJwx2rcuU2***********3ZK5rb-AGak'; //初始化人脸分析 $face = new \weiwei2012holy\Face($key, $secret); //初始化图像分析 $image = new \weiwei2012holy\Image($key, $secret); ``` #### 2.1 人脸分析 [](#21-人脸分析) **2.1.1 发起人脸分析** ``` //图片可以是链接,文件路径或者base64编码数据,自动处理 $mUrl = 'https://wx-static.yidejia.com/fandom1541484919647'; //发起皮肤分析 $mUrlDetail = $face->detect($mUrl, 'skinstatus'); ``` 请求成功示例: ``` Array ( [image_id] => pFVWo+CGnzn2eoEO8AW28w== [request_id] => 1542263847,2612d95b-8fef-4d3e-b10a-0b5ca110fe9c [time_used] => 537 [faces] => Array ( [0] => Array ( [attributes] => Array ( [skinstatus] => Array ( [dark_circle] => 3.157 [stain] => 10.996 [acne] => 5.3 [health] => 4.423 ) ) [face_rectangle] => Array ( [width] => 377 [top] => 202 [left] => 19 [height] => 377 ) [face_token] => 6d265e22d06cbb9e62f853b22cf296c5 ) ) ) ``` **2.1.2 人脸美颜美白** ``` 人脸美白 $url = 'https://wx-static.yidejia.com/fandom1536201951787'; $res = $face->beautify($url); file_put_contents('美颜.png', base64_decode($res['result'])); ``` 请求成功响应格式: ``` { "time_used": 544, "result":……省略 base64 图片数据 } ``` **2.1.3 人脸对比** ``` //人脸对比 $url1 = 'https://wx-static.yidejia.com/fandom1536201951787'; //$url2 = 'https://wx-static.yidejia.com/fandom1536201951787'; $url2 = '0337a0d38d5c89b4c15098a695572414'; //$url1 = '0337a0d38d5c89b4c15098a695572414'; $res = $face->compare($url1, $url2); ``` 响应示例: ``` Array ( [confidence] => 97.389 [request_id] => 1542265057,9658622d-61e8-4570-95b7-85a8ad4b415d [time_used] => 623 [thresholds] => Array ( [1e-3] => 62.327 [1e-5] => 73.975 [1e-4] => 69.101 ) ) ``` #### 2.2 face set 管理 [](#22-face-set-管理) **2.2.1 创建faceSet** ``` $res = $face->faceSetCreate('测试2','test2'); ``` 返回数据: ``` Array ( [faceset_token] => f17b4dec9507927fa3dd5cc286c27923 [time_used] => 180 [face_count] => 0 [face_added] => 0 [request_id] => 1542262652,e9cb60e7-b354-4744-8fb3-8a9918265ced [outer_id] => test2 [failure_detail] => Array ( ) ) ``` **2.2.2 获取face set列表** ``` $res = $face->faceSetGetFaceSets(); ``` 返回数据: ``` Array ( [time_used] => 80 [next] => ...分页用的参数 [facesets] => Array ( [0] => Array ( [faceset_token] => 154a366740b29b5ab020c3714a8bb932 [outer_id] => [display_name] => 测试1 [tags] => ) [1] => Array ( [faceset_token] => f17b4dec9507927fa3dd5cc286c27923 [outer_id] => test2 [display_name] => 测试2 [tags] => ) ) [request_id] => 1542264730,7229c308-452e-454e-88f4-c889ee13775e ) ``` **2.2.3 更新face set** ``` //更新face set $res = $face->faceSetUpdate('154a366740b29b5ab020c3714a8bb932', ['new_outer_id' => 'test1']); ``` 响应示例: ``` Array ( [faceset_token] => 154a366740b29b5ab020c3714a8bb932 [request_id] => 1542266624,6cc031b3-43a6-4c1c-9e83-85e25d6a3409 [time_used] => 102 [outer_id] => test1 ) ``` **2.2.4 获取face set 详情** ``` $res = $face->faceSetGetDetail('154a366740b29b5ab020c3714a8bb932'); ``` 响应示例: ``` Array ( [faceset_token] => f17b4dec9507927fa3dd5cc286c27923 [tags] => [time_used] => 444 [user_data] => [display_name] => 测试2 [face_tokens] => Array ( [0] => 7b84a3cb51caab1a02b48a60d677e260 ) [face_count] => 1 [request_id] => 1542273001,2293b317-8089-4d66-934c-f290254b01ca [outer_id] => test2 ) ``` **2.2.5 删除face set** ``` $res = $face->faceSetDelete('154a366740b29b5ab020c3714a8bb932'); ``` 响应示例: ``` Array ( [faceset_token] => 154a366740b29b5ab020c3714a8bb932 [request_id] => 1542269667,9b46e488-3e5d-4b14-b36b-158370f1b6d1 [time_used] => 325 [outer_id] => test1 ) ``` **2.2.6 往face set 添加face\_token** ``` $res = $face->faceSetAddFace($faceSetToken,'7b84a3cb51caab1a02b48a60d677e260'); ``` 响应示例: ``` 同步请求: Array ( [faceset_token] => f17b4dec9507927fa3dd5cc286c27923 [time_used] => 96 [face_count] => 1 [face_added] => 0 [request_id] => 1542272991,0ac07155-12ed-4456-a410-46780be72e3d [outer_id] => test2 [failure_detail] => Array ( ) ) 如果为异步请求,则返回数据为: Array ( [time_used] => 154 [task_id] => 9e108e86-f47c-46b6-9ada-cdc7c2c7a648 [request_id] => 1542273307,9832ced0-ee67-49f7-83db-5c274dd5e25e ) ``` **2.2.7 往face set 删除face token** ``` $res = $face->faceSetRemoveFace($faceSetToken, '55ad5a72d902af5e582a56769cbcbb05', false, true); ``` **2.2.8 获取face token的详情** ``` $res = $face->faceAnalyze($faceToken,'emotion'); ``` **2.2.9 查询异步任务情况** ``` $res = $face->faceSetTaskStatus($taskId); ``` 响应示例: ``` Array ( [status] => 1 [faceset_token] => f17b4dec9507927fa3dd5cc286c27923 [time_used] => 31 [task_id] => fa6a190b-d061-4bed-90b5-7ac394b7c962 [face_count] => 5 [face_added] => 0 [request_id] => 1542273533,0c2cdb55-4bb0-4278-b4c5-5a2c0c1667b4 [outer_id] => test2 [failure_detail] => Array ( ) ) ``` \*\* 呵呵\*\* ``` ``` 返回数据: ``` ``` #### 2.3 图像分析 [](#23-图像分析) **2.3.1 发起人脸融合** ``` $angle = ['top', 'left', 'width', 'height']; $mUrl = 'https://wx-static.yidejia.com/fandom1541484919647'; //发起人脸分析 $mUrlDetail = $face->detect($mUrl); $mUrlFace = $mUrlDetail['faces'][0]; foreach ($angle as $item) { $mAngle[$item] = $mUrlFace['face_rectangle'][$item]; } $mAngle = implode(',', $mAngle); print_r($mUrlFace); $tUrl = 'http://img2.jiemian.com/101/original/20160129/145404008426286800.jpg'; $tUrlDetail = $face->detect($tUrl); $tUrlFace = $tUrlDetail['faces'][0]; foreach ($angle as $item) { $tAngle[$item] = $tUrlFace['face_rectangle'][$item]; } $tAngle = implode(',', $tAngle); print_r($tUrlFace); //发起人脸融合 $res = $image->mergeFace($tUrl, $tAngle, $mUrl, $mAngle, 70); print_r($res); ``` 请求成功示例: ``` { "time_used": 544, "result":……省略 base64 图片数据, "request_id": "1510906671,53ca1f2b-c3d8-473a-858c-3b4fd99ef07a" } ``` ### Health Score 22 — LowBetter than 22% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity15 Limited adoption so far Community4 Small or concentrated contributor base Maturity38 Early-stage or recently created project How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/fe50933123ea688b7950b461258a3a96b074144613424337819eccafbe92d7a0?d=identicon)[weiwei2012holy](/maintainers/weiwei2012holy) --- Tags faceplusplusr-l-s-b ### Embed Badge ![Health badge](/badges/weiwei2012holy-faceplusplus/health.svg) ``` [![Health](https://phpackages.com/badges/weiwei2012holy-faceplusplus/health.svg)](https://phpackages.com/packages/weiwei2012holy-faceplusplus) ``` ### Alternatives [stripe/stripe-php Stripe PHP Library 4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk A PHP wrapper for Twilio's API 1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api GitHub API v3 client 2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk PHP SDK for Facebook Business 90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php PHP wrapper for the Meilisearch API 73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax Google API Core for PHP 263103.1M454](/packages/google-gax) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)