README
Face Detection and Analysis Package
This web service has been designed from the ground up to give developers easy access to face information present in images. By sending a picture with one or more faces, the service will reply with a JSON response containing the following information:
- Age
- Gender
- Mood
- Facial Expressions
- Face Position
- Face Rotation
- Eye Position
- Traking Points
- Clothing Colors
The basic account gives you access to a limited amount of API requests per month for free with a base rate limit of one request per second. In order to guarantee continuation of operation for your application, you will have to upgrade to one of our paid monthly subscriptions. For more information, see the pricing page
- Domain: face.sightcorp.com
- Credentials: appKey
How to get credentials:
- Go to the Service page
- Create Sightcorp’s Face API account or log in.
- Choose “Trial” to create a new account with 2 weeks of trial or choose a subscription plan.
- In the dashboard you will see your new app, Copy your appKey.
FaceDetectionAndAnalisys.detect [File]
By sending a picture with one or more faces, the service will reply with a JSON response containing the following information: Age, Gender, Mood, Facial Expressions, Face Position, Face Rotation, Eye Position, Traking Points, Clothing Colors.
| Field | Type | Description |
|---|---|---|
| app_key | credentials | Required: The app key obtained from Sightcorp Face API Service. The application key is a 32 characters string that bounds the request to the app of the user in the server. This string allows the request to be authenticated. |
| img | File | Required: The image to analyze. When this field is set, the content type of the request has to be multipart/form-data. The supported file formats are jpeg and png. |
FaceDetectionAndAnalisys.detect [Url]
By sending a url from a picture with one or more faces, the service will reply with a JSON response containing the following information: Age, Gender, Mood, Facial Expressions, Face Position, Face Rotation, Eye Position, Traking Points, Clothing Colors.
| Field | Type | Description |
|---|---|---|
| app_key | credentials | Required: The app key obtained from Sightcorp Face API Service. The application key is a 32 characters string that bounds the request to the app of the user in the server. This string allows the request to be authenticated. |
| url | File | Required: A URL pointing to an image. When this field is set, the img field must not be present in the request. The F.A.C.E. servers will download the remote resource and perform face analysis, however, if the remote server does not provide the content type, the content type is not correct (image/*) or the download takes more than 5 seconds, the download is aborted. |
