You are viewing a section of Superface that will be deprecated in Q4 2023. Until then, you can continue to use it as you have before but we recommend that you migrate to our latest version soon. For more details visit superface.ai/docs/migrate.
Face Detection
computer-vision/face-detection@1.0.21 provider
Face Detection
Detects faces on publicly-accessible image URL
Input
Image URL
Result
faces
1.Choose a provider
2.Use FaceDetection with mock in your code
Below instructions are for our Node.js SDK. Use OneService for other languages.
npm i @superfaceai/one-sdk
Structure details
Input (object)
imageUrl
required
Publicly-accessible image URL
string
Example
Result (list of objects)
faces
required
list
faceRectangle
required
object
topLeft
required
object
x
optional
number
y
optional
number
topRight
required
object
x
optional
number
y
optional
number
bottomLeft
required
object
x
optional
number
y
optional
number
bottomRight
required
object
x
optional
number
y
optional
number
landmarks
required
list
kind
required
enum
leftPupileyeLeftOutereyeLeftTopeyeLeftBottomeyeLeftInnerrightPupileyeRightOutereyeRightTopeyeRightBottomeyeRightInnereyebrowLeftOutereyebrowLeftInnereyebrowRightInnereyebrowRightOuternoseTipnoseRootLeftnoseRootRightmouthLeftmouthRight
x
required
number
y
required
number
emotions
required
object
happiness
required
enum
unknownveryUnlikelyunlikelypossiblelikelyveryLikely
anger
required
enum
unknownveryUnlikelyunlikelypossiblelikelyveryLikely
sadness
required
enum
unknownveryUnlikelyunlikelypossiblelikelyveryLikely
surprise
required
enum
unknownveryUnlikelyunlikelypossiblelikelyveryLikely