FacePlusPlus - An Overview
This package can be used to Detect and locate human faces within an image, and returns high-precision face bounding boxes. Face++ also allows you to store metadata of detected faces for future use.
Facial Recognition Basics.
Face
In facial recognition technologies, Face indicates the faces detected in images. When performing face detection to an image, the detected faces will be recorded, along with face locations in the image. Face will be marked by unique id called face_token. Please note that if you perform face detection to the same image for several times, a same face will get different face_token.
FaceSet
FaceSet serves to store the detected faces. Each face_token in a FaceSet is unduplicated.
Additional Information
Principle
Face++ APIs are HTTP API. You can make API request using any popular programming language (by third party library or owned API). Developers make HTTP request to our server with appropriate parameters. The server will process the request and return the result.
Authentication
Every application created will have its API_key And API_secret, which is used to verify whether the request is authenticated. Each API request should provide a set of API_key and API_secret.
Please note that API credentials of old Face++ cannot be used in Face++ Cognitive Services. Please use the API_key and API_secret you get from Face++ Cognitive Services console.
Parameter
You need to pass the parameters according to the requirements of each API. Please turn to the API Reference for more details.
Each API request must be POST request. You can add the parameters in the form of Query String, and use multipart/form-data to upload image files.
Tips
In order to avoid the block caused by internet connection problems, please use asynchronous thread to perform API request.
Prerequisites:
Before using API, you need to first create an account.
Go to the following site:
https://console.faceplusplus.com/documents/7079083
Click on Get API Key and follow the guide in step one to complete your registration.
Step two will guide you to get the API Key. API Key is used for authentication in API request.
Important Note: Please keep this somewhere safe and secure. Both API Key and API Secret are required to use this activity.
Image Requirements
Format: JPG (JPEG), PNG
Size: between 48*48 and 4096*4096 (pixels)
File size: no larger than 2MB
Minimal size of face: the bounding box of a detected face is a square. The minimal side length of a square should be no less than 150 pixels.
Request Parameter
Note: When you create an API key, you can choose Free API Key or Standard API Key. If you would like to use Free API service, or to test Mobile SDK, you can use Free API key - It's totally free. If you want to use premium API key, or to license Mobile SDK, please create a Standard API Key.
You need to set up the name, category and platform of your application.
For more details regarding pricing, payment, etc., that are subject to change, please refer the FAQ Section and contact the concerned personnel.