README

This SDK is the wrapper for faceplusplus.com's API. Provides modern ways to use the API in PHP.

Install

It's very easy to install via composer

composer require nguyenvanduocit/face-sdk

Register API

This API is free to use, you can register your application at FacePlusPlus to get apiKey and apiSecretKey.

Usage

require_once '../vendor/autoload.php';
use FaceSDK\Node\RecognizedImage;
$faceAPI = new \FaceSDK\FaceSDK( 'YOUR_API', 'YOUR_API', 'http://apicn.faceplusplus.com' );
$response  = $faceAPI->post( '/detection/detect', [
	'url' => 'http://2anhdep.vn/wp-content/uploads/2014/11/anh-ngoc-trinh-dep-trong-nhung-bo-noi-y-xuyen-thau-khien-nguoi-xem-do-mat-6.jpg',
	'attribute'=>'glass,gender,age,race,smiling,glass,pose'
] );

/** @var RecognizedImage $detectedImage */
$detectedImage = $response->getRecognizedImage();
var_dump('$detectedImage', $detectedImage);

/** @var \FaceSDK\Node\RecognizedFace[] $faces */
$faces = $detectedImage->getFaces();
var_dump('$faces', $faces);

/** @var \FaceSDK\Node\RecognizedFaceAttribute $attrs */
$attrs =  $faces[0]->getAttributes();
var_dump('$attrs', $attrs);

Example

There are two example in folder example :

face-hightlight.php : Draw a rectangle around main face, and tell if she/he is smiling
face-recognize.php : The demo with the example code below.

TODO

Implement all API from FacePlusPlus Doc
Improve Exception

Contribute

Feel free to make PR

Development

This SDK was shipped with many implement and lesson from Facebook PHP SDK.

nguyenvanduocit / face-sdk

Maintainers

Details