Overview
The PyImageSearch API is a free to collection of endpoints aimed at teaching concepts in computer vision and OpenCV. Right now the API only includes methods for face detection, but this will expand as the PyImageSearch blog grows and new articles are published.
POST: /face_detection/detect/
Detects faces in images either via uploaded file or URL of image. The response will include a JSON dictionary consisting of:
Key | Data Type | Description |
---|---|---|
success | boolean | Indicates whether or not the request was successful or not. |
num_faces | int | Number of faces detected in the image. |
faces | list | Starting and ending (x, y)-coordinates for each face in the image. |
URL Upload Example
$ curl -X POST 'http://api.pyimagesearch.com/face_detection/detect/' -d 'url=http://www.pyimagesearch.com/wp-content/uploads/2015/05/obama.jpg' {"num_faces": 1, "success": true, "faces": [[410, 100, 591, 281]]}
File Upload Example
$ curl -X POST -F image=@obama.jpg 'http://api.pyimagesearch.com/face_detection/detect/' {"num_faces": 1, "success": true, "faces": [[410, 100, 591, 281]]}
For more examples on using the PyImageSearch web API, including examples in Python, please refer to this blog post.
[BASE URL: /, API VERSION: 1.0.0]