FaceDetection - Algorithm by dlib

No algorithm description given

Introduction This algorithm detects human faces in given images. Works best with forward facing faces. Input (Required): Image URL (http(s) url or dataAPI url) (Optional): Detected faces image save location Output Image URL Detected faces coordinates Detected faces image (if save location given) Example(s) Example 1. Parameter 1: Image URL {
 "images": [
 {
 "url": "https://en.wikipedia.org/wiki/Barack_Obama#/media/File:DIG13623-230.jpg"
 }
 ]
} Output: {
 "images": [
 {
 "detected_faces": [
 {
 "bottom": 1704,
 "left": 1882,
 "right": 2203,
 "top": 1383
 },
 {
 "bottom": 1660,
 "left": 632,
 "right": 1017,
 "top": 1274
 }
 ],
 "url": "https://en.wikipedia.org/wiki/Barack_Obama#/media/File:DIG13623-230.jpg"}
 ]
} Example 2. Parameter 1: Multiple Image URLs {
 "images": [
 {
 "url": "https://en.wikipedia.org/wiki/Barack_Obama#/media/File:DIG13623-230.jpg"
 },
 {
 "url": "https://upload.wikimedia.org/wikipedia/commons/b/b6/Obamamiltondavis1.jpg"
 }
 ]
} Output: {
 "images": [
 {
 "detected_faces": [
 {
 "bottom": 1704,
 "left": 1882,
 "right": 2203,
 "top": 1383
 },
 {
 "bottom": 1660,
 "left": 632,
 "right": 1017,
 "top": 1274
 }
 ],
 "url": "https://en.wikipedia.org/wiki/Barack_Obama#/media/File:DIG13623-230.jpg"
 },
 {
 "detected_faces": [
 {
 "bottom": 182,
 "left": 377,
 "right": 429,
 "top": 130
 },
 {
 "bottom": 228,
 "left": 290,
 "right": 333,
 "top": 185
 },
 {
 "bottom": 218,
 "left": 93,
 "right": 136,
 "top": 175
 },
 {
 "bottom": 257,
 "left": 204,
 "right": 247,
 "top": 214
 },
 {
 "bottom": 278,
 "left": 25,
 "right": 61,
 "top": 242
 }
 ],
 "url": "https://upload.wikimedia.org/wikipedia/commons/b/b6/Obamamiltondavis1.jpg"
 }
 ]
} Example 3. Parameter 1: Image URL Parameter 2: Detected faces image save location {
 "images": [
 {
 "url": "https://en.wikipedia.org/wiki/Barack_Obama#/media/File:DIG13623-230.jpg",
 "output": "data://.algo/temp/detected_faces.png"
 }
 ]
} Output: {
 "images": [
 {
 "detected_faces": [
 {
 "bottom": 1704,
 "left": 1882,
 "right": 2203,
 "top": 1383
 },
 {
 "bottom": 1660,
 "left": 632,
 "right": 1017,
 "top": 1274
 }
 ],
 "output": "data://.algo/temp/detected_faces.png",
 "url": "https://en.wikipedia.org/wiki/Barack_Obama#/media/File:DIG13623-230.jpg"
 }
 ]
} Credits Description from Facial Recognition Wikipedia . Face recognition model from dlib . Example image from Unsplash .

Tags

(no tags)

Cost Breakdown

0 cr

royalty per call

1 cr

usage per second

avg duration

This algorithm has permission to call other algorithms which may incur separate royalty and usage costs.

Cost Calculator

API call duration (sec)

API calls

Estimated cost

per calls

for large volume discounts

For additional details on how pricing works, see Algorithmia pricing.

Internet access

This algorithm has Internet access. This is necessary for algorithms that rely on external services, however it also implies that this algorithm is able to send your input data outside of the Algorithmia platform.

Calls other algorithms

This algorithm has permission to call other algorithms. This allows an algorithm to compose sophisticated functionality using other algorithms as building blocks, however it also carries the potential of incurring additional royalty and usage costs from any algorithm that it calls.

To understand more about how algorithm permissions work, see the permissions documentation.

1. Type your input

2. See the result

Running algorithm...

curl -X POST -d '{{input | formatInput:"curl"}}' -H 'Content-Type: application/json' -H 'Authorization: Simple YOUR_API_KEY' https://api.algorithmia.com/v1/algo/dlib/FaceDetection/0.2.1

View cURL Docs

algo auth
# Enter API Key: YOUR_API_KEY
algo run algo://dlib/FaceDetection/0.2.1 -d '{{input | formatInput:"cli"}}'

View CLI Docs

import (
  algorithmia "github.com/algorithmiaio/algorithmia-go"
)

input := {{input | formatInput:"go"}}

var client = algorithmia.NewClient("YOUR_API_KEY", "")
algo, _ := client.Algo("algo://dlib/FaceDetection/0.2.1")
resp, _ := algo.Pipe(input)
response := resp.(*algorithmia.AlgoResponse)
fmt.Println(response.Result)

View Go Docs

import com.algorithmia.*;
import com.algorithmia.algo.*;

String input = "{{input | formatInput:"java"}}";
AlgorithmiaClient client = Algorithmia.client("YOUR_API_KEY");
Algorithm algo = client.algo("algo://dlib/FaceDetection/0.2.1");
AlgoResponse result = algo.pipeJson(input);
System.out.println(result.asJsonString());

View Java Docs

import com.algorithmia._
import com.algorithmia.algo._

val input = {{input | formatInput:"scala"}}
val client = Algorithmia.client("YOUR_API_KEY")
val algo = client.algo("algo://dlib/FaceDetection/0.2.1")
val result = algo.pipeJson(input)
System.out.println(result.asJsonString)

View Scala Docs

var input = {{input | formatInput:"javascript"}};
Algorithmia.client("YOUR_API_KEY")
           .algo("algo://dlib/FaceDetection/0.2.1")
           .pipe(input)
           .then(function(output) {
             console.log(output);
           });

View Javascript Docs

using Algorithmia;

var input = "{{input | formatInput:"cs"}}";
var client = new Client("YOUR_API_KEY");
var algorithm = client.algo("algo://dlib/FaceDetection/0.2.1");
var response = algorithm.pipe<object>(input);
Console.WriteLine(response.result);

View .NET/C# Docs

var input = {{input | formatInput:"javascript"}};
Algorithmia.client("YOUR_API_KEY")
           .algo("algo://dlib/FaceDetection/0.2.1")
           .pipe(input)
           .then(function(response) {
             console.log(response.get());
           });

View NodeJS Docs

import Algorithmia

input = {{input | formatInput:"python"}}
client = Algorithmia.client('YOUR_API_KEY')
algo = client.algo('dlib/FaceDetection/0.2.1')
print algo.pipe(input)

View Python Docs

library(algorithmia)

input <- {{input | formatInput:"r"}}
client <- getAlgorithmiaClient("YOUR_API_KEY")
algo <- client$algo("dlib/FaceDetection/0.2.1")
result <- algo$pipe(input)$result
print(result)

View R Docs

require 'algorithmia'

input = {{input | formatInput:"ruby"}}
client = Algorithmia.client('YOUR_API_KEY')
algo = client.algo('dlib/FaceDetection/0.2.1')
puts algo.pipe(input).result

View Ruby Docs

use algorithmia::Algorithmia;

let input = {{input | formatInput:"rust"}};
let client = Algorithmia::client("YOUR_API_KEY");
let algo = client.algo("dlib/FaceDetection/0.2.1");
let response = algo.pipe(input);

View Rust Docs

import Algorithmia

let input = "{{input | formatInput:"swift"}}";
let client = Algorithmia.client(simpleKey: "YOUR_API_KEY")
let algo = client.algo(algoUri: "dlib/FaceDetection/0.2.1") { resp, error in
  print(resp)
}

View Swift Docs

Discussion