Oops, that didn't work. Please try again later.
The Chooch API is organized around REST. The API recognizes objects and concepts in videos and
images from our pre-trained
models.
The API is compatible with livestreams and live tagging.
The image recognition API is a straightforward REST API conducting classification and object recognition predictions on images. The image URL is passed as a field to the API and the API returns a JSON based response with relevant predictions.
# Image Recognition with Local Image
import requests
import json
url = 'https://api.chooch.ai/predict/image?apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19'
files = {'image': open('local_image.jpg', 'rb')}
response = requests.post(url, files=files)
print(response.content)
var form = new FormData();
form.append("image", "");
var settings = {
"url": "https://api.chooch.ai/predict/image?apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19",
"method": "POST",
"timeout": 0,
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.chooch.ai/predict/image?apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => array('image'=> new CURLFILE('')),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
} ?>
curl --location --request POST "https://api.chooch.ai/predict/image?apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19" --form "image=@"
# Image Recognition with Image Url
import requests
import json
url = 'https://api.chooch.ai/predict/image?url=https://s3.amazonaws.com/choochdashboard/base_site/ronaldo_suit.jpg&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19'
response = requests.post(url)
print(response.content)
var form = new FormData();
var settings = {
"url": "https://api.chooch.ai/predict/image?url=https://s3.amazonaws.com/choochdashboard/base_site/ronaldo_suit.jpg&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19",
"method": "GET",
"timeout": 0,
"headers": {
"Content-Type": "application/json"
},
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.chooch.ai/predict/image?url=https://s3.amazonaws.com/choochdashboard/base_site/ronaldo_suit.jpg&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"Content-Type: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
} ?>
curl --location --request GET "https://api.chooch.ai/predict/image?url=https://s3.amazonaws.com/choochdashboard/base_site/ronaldo_suit.jpg&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19" --header "Content-Type: application/json"
API input fields are:
The sample JSON response is:
{
"status": "ok",
"url": "https://s3.amazonaws.com/choochdashboard/base_site/ronaldo_suit.jpg",
"predictions": [
{
"class_title": "Cristiano Ronaldo",
"order": "1"
},
{
"class_title": "tom ford style",
"order": "2"
},
{
"class_title": "double-breasted suit, fashion",
"order": "3"
},
{
"class_title": "man",
"order": "6"
},
{
"class_title": "suit",
"order": "7"
},
{
"class_title": "cartoon, sterling archer",
"order": "8"
},
{
"class_title": "icon",
"order": "9"
},
{
"class_title": "man's clothing",
"order": "10"
},
{
"class_title": "face",
"order": "11"
},
{
"class_title": "male",
"order": "12"
},
{
"class_title": "young man",
"order": "13"
},
{
"class_title": "actor, doer",
"order": "14"
},
{
"class_title": "tie",
"order": "15"
},
{
"class_title": "striped tie",
"order": "16"
},
{
"class_title": "windsor tie",
"order": "17"
},
{
"class_title": "four-in-hand tie",
"order": "18"
},
{
"class_title": "cravat",
"order": "19"
}
],
"texts": {
"status": "limited to 15 results",
"predictions": [
],
"summary": [
]
},
"objects": {
"predictions": [
{
"sub_predictions": [
{
"class_title": "tom ford style",
"order": 1
},
{
"class_title": "double breasted suit",
"order": 2
},
{
"class_title": "brown tie",
"order": 3
},
{
"class_title": "double-breasted suit, fashion",
"order": 4
}
],
"object_title": "man",
"coordinates": "0,749,64,982"
},
{
"sub_predictions": [
{
"class_title": "cartoon, sterling archer",
"order": 1
},
{
"class_title": "tom ford style",
"order": 2
},
{
"class_title": "sterling archer",
"order": 3
},
{
"class_title": "double breasted suit",
"order": 4
},
{
"class_title": "brown tie",
"order": 5
},
{
"class_title": "double-breasted suit, fashion",
"order": 6
},
{
"class_title": "icon",
"order": 7
},
{
"class_title": "man's clothing",
"order": 8
}
],
"object_title": "suit",
"coordinates": "25,712,305,995"
},
{
"sub_predictions": [
{
"class_title": "male",
"order": 1
},
{
"class_title": "young man",
"order": 2
},
{
"class_title": "actor, doer",
"order": 3
}
],
"object_title": "face",
"coordinates": "225,504,75,464"
},
{
"sub_predictions": [
{
"class_title": "striped tie",
"order": 1
},
{
"class_title": "windsor tie",
"order": 2
},
{
"class_title": "four-in-hand tie",
"order": 3
},
{
"class_title": "cravat",
"order": 4
}
],
"object_title": "tie",
"coordinates": "320,436,523,875"
}
],
"summary": [
{
"count": "1",
"object_title": "tie"
},
{
"count": "1",
"object_title": "face"
},
{
"count": "1",
"object_title": "suit"
},
{
"count": "1",
"object_title": "man"
}
]
},
"faces": {
"face_count": 1,
"predictions": [
{
"face_name": "Cristiano Ronaldo",
"coordinates": "248,506,192,450"
}
]
},
"predicttype": "dense",
"fileid": "c2f02758f0dd4b8ab703e26f4d70d7c7"
}
The response fields are:
The video recognition API is a REST API indexing videos every second. The API consists of 2 parts: 1) send video and 2) search. The indexing begins by sending the video. After sending the video, the indexed data can be viewed through the search API.
The following is a sample send video URL for indexing to begin:
API input fields are:
The sample JSON response is:
{
url: "https://s3.amazonaws.com/choochvideo/51.mp4",
status: "Success (Video is being indexed)",
predicttype: "video",
fileid: "55de9d9ce1e2469da3a420a7b4de9397"
}
The response fields are:
After the video is indexed, the indexed data can be viewed through the search API by using the File ID of the video. The following is a sample API request URL for viewing indexed data.
API input fields are:
The sample JSON response is:
{
status: "ok",
url: "https://s3.amazonaws.com/choochvideo/51.mp4",
indexstatus: "Success (Video Has Been Indexed)",
seconds: [{
texts: {
status: "limited to 15 results",
predictions: [
{
text_value: "sports",
coordinates: "556,773,379,422"
},
{
text_value: "scenter",
coordinates: "751,1041,376,432"
},
{
text_value: "allaccess",
coordinates: "631,973,458,507"
},
{
text_value: "ronald",
coordinates: "592,994,519,616"
},
{
text_value: "in",
coordinates: "682,735,614,650"
},
{
text_value: "china",
coordinates: "748,922,616,660"
}
],
summary: [
{
count: "1",
text_value: "allaccess"
},
{
count: "1",
text_value: "sports"
},
{
count: "1",
text_value: "ronald"
},
{
count: "1",
text_value: "china"
},
{
count: "1",
text_value: "in"
},
{
count: "1",
text_value: "scenter"
}
]
},
second: 1,
objects: {
predictions: [
{
sub_predictions: [ ],
object_title: "illustration",
coordinates: "211,1138,142,712"
},
{
sub_predictions: [
{
class_title: "victory",
order: 1
},
{
class_title: "joy",
order: 2
}
],
object_title: "man",
coordinates: "190,580,319,712"
},
{
sub_predictions: [ ],
object_title: "face",
coordinates: "279,511,325,658"
},
{
sub_predictions: [ ],
object_title: "person",
coordinates: "978,1089,571,716"
},
{
sub_predictions: [ ],
object_title: "clothing",
coordinates: "971,1097,602,712"
},
{
sub_predictions: [ ],
object_title: "illustration",
coordinates: "211,1138,142,712"
},
{
sub_predictions: [
{
class_title: "victory",
order: 1
},
{
class_title: "joy",
order: 2
}
],
object_title: "man",
coordinates: "190,580,319,712"
},
{
sub_predictions: [ ],
object_title: "face",
coordinates: "279,511,325,658"
},
{
sub_predictions: [ ],
object_title: "person",
coordinates: "978,1089,571,716"
},
{
sub_predictions: [ ],
object_title: "clothing",
coordinates: "971,1097,602,712"
}
],
summary: [
{
count: "2",
object_title: "person"
},
{
count: "2",
object_title: "face"
},
{
count: "2",
object_title: "clothing"
},
{
count: "2",
object_title: "illustration"
},
{
count: "2",
object_title: "man"
}
]
},
predictions: [
{
class_title: "cristiano ronaldo",
order: "1"
},
{
class_title: "illustration",
order: "2"
},
{
class_title: "man",
order: "3"
},
{
class_title: "victory",
order: "4"
},
{
class_title: "joy",
order: "5"
},
{
class_title: "face",
order: "6"
},
{
class_title: "sports",
order: "7"
},
{
class_title: "scenter",
order: "8"
},
{
class_title: "allaccess",
order: "9"
},
{
class_title: "ronald",
order: "10"
},
{
class_title: "in",
order: "11"
},
{
class_title: "china",
order: "12"
}
],
faces: {
face_count: 1,
predictions: [
{
face_name: "Cristiano Ronaldo",
coordinates: "212,390,292,472"
}
]
}
},
{
texts: {
status: "limited to 15 results",
predictions: [
{
text_value: "scenter",
coordinates: "712,1023,279,339"
},
{
text_value: "sorts",
coordinates: "512,745,302,345"
},
{
text_value: "allfaccess",
coordinates: "583,937,366,417"
},
{
text_value: "onald",
coordinates: "545,970,428,530"
},
{
text_value: "i",
coordinates: "626,683,534,572"
},
{
text_value: "china",
coordinates: "690,906,529,582"
},
{
text_value: "mra",
coordinates: "1042,1084,568,584"
},
{
text_value: "s",
coordinates: "957,993,652,671"
}
],
summary: [
{
count: "1",
text_value: "allfaccess"
},
{
count: "1",
text_value: "i"
},
{
count: "1",
text_value: "mra"
},
{
count: "1",
text_value: "s"
},
{
count: "1",
text_value: "china"
},
{
count: "1",
text_value: "sorts"
},
{
count: "1",
text_value: "onald"
},
{
count: "1",
text_value: "scenter"
}
]
},
second: 2,
objects: {
predictions: [
{
sub_predictions: [
{
class_title: "maybe olympics",
order: 1
}
],
object_title: "man",
coordinates: "78,547,267,712"
},
{
sub_predictions: [
{
class_title: "psycho joker",
order: 1
}
],
object_title: "face",
coordinates: "241,455,271,582"
},
{
sub_predictions: [
{
class_title: "forward",
order: 1
},
{
class_title: "back",
order: 2
}
],
object_title: "man",
coordinates: "965,1150,467,712"
},
{
sub_predictions: [ ],
object_title: "person",
coordinates: "981,1145,459,707"
},
{
sub_predictions: [ ],
object_title: "clothing",
coordinates: "987,1150,503,697"
},
{
sub_predictions: [
{
class_title: "maybe olympics",
order: 1
}
],
object_title: "man",
coordinates: "78,547,267,712"
},
{
sub_predictions: [
{
class_title: "psycho joker",
order: 1
}
],
object_title: "face",
coordinates: "241,455,271,582"
},
{
sub_predictions: [
{
class_title: "forward",
order: 1
},
{
class_title: "back",
order: 2
}
],
object_title: "man",
coordinates: "965,1150,467,712"
},
{
sub_predictions: [ ],
object_title: "person",
coordinates: "981,1145,459,707"
},
{
sub_predictions: [ ],
object_title: "clothing",
coordinates: "987,1150,503,697"
}
],
summary: [
{
count: "4",
object_title: "man"
},
{
count: "2",
object_title: "person"
},
{
count: "2",
object_title: "face"
},
{
count: "2",
object_title: "clothing"
}
]
},
predictions: [
{
class_title: "cristiano ronaldo",
order: "1"
},
{
class_title: "man - 1",
order: "2"
},
{
class_title: "maybe olympics",
order: "3"
},
{
class_title: "face",
order: "4"
},
{
class_title: "psycho joker",
order: "5"
},
{
class_title: "man - 2",
order: "6"
},
{
class_title: "forward",
order: "7"
},
{
class_title: "back",
order: "8"
},
{
class_title: "scenter",
order: "9"
},
{
class_title: "sorts",
order: "10"
},
{
class_title: "allfaccess",
order: "11"
},
{
class_title: "onald",
order: "12"
},
{
class_title: "i",
order: "13"
},
{
class_title: "china",
order: "14"
},
{
class_title: "mra",
order: "15"
},
{
class_title: "s",
order: "16"
}
],
faces: {
face_count: 1,
predictions: [
{
face_name: "Cristiano Ronaldo",
coordinates: "192,342,260,408"
}
]
}
},
],
index_status: "Success (Video Has Been Indexed)",
fileid: "55de9d9ce1e2469da3a420a7b4de9397"
}
The response fields are:
The FTP drop function was developed on top of the Chooch API for image and video professionals who want to tag their images and videos autonomously. For every client a personal FTP host is issued together with the API.
The FTP drop sends the image to the API. The API predicts the image and places the results in the keywords field of the IPTC metadata file. Once the metadata has been successfully placed into the keywords fields of the IPTC file, it is sent to the destination directed by the user.
# Image Recognition with Local Image
import requests
import json
url = 'https://api.chooch.ai/predict/image?apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19&model_id=808'
files = {'image': open('local_image.jpg', 'rb')}
response = requests.post(url, files=files)
print(response.content)
var form = new FormData();
form.append("image", "");
var settings = {
"url": "https://api.chooch.ai/predict/image?apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19&model_id=808",
"method": "POST",
"timeout": 0,
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.chooch.ai/predict/image?apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19&model_id=808",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => array('image'=> new CURLFILE('')),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
} ?>
curl --location --request POST "https://api.chooch.ai/predict/image?apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19&model_id=808" --form "image=@"
# Image Recognition with Image Url
import requests
import json
url = 'https://api.chooch.ai/predict/image?url=https://chooch-share.s3.amazonaws.com/cat.jpg&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19&model_id=808'
response = requests.post(url)
print(response.content)
var form = new FormData();
var settings = {
"url": "https://api.chooch.ai/predict/image?url=https://chooch-share.s3.amazonaws.com/cat.jpg&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19&model_id=808",
"method": "GET",
"timeout": 0,
"headers": {
"Content-Type": "application/json"
},
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.chooch.ai/predict/image?url=https://chooch-share.s3.amazonaws.com/cat.jpg&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19&model_id=808",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"Content-Type: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
} ?>
curl --location --request GET "https://api.chooch.ai/predict/image?url=https://chooch-share.s3.amazonaws.com/cat.jpg&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19&model_id=808" --header "Content-Type: application/json"
API input fields are:
The sample JSON response is:
{
"status": "ok",
"model_id": "808",
"url": "https://chooch-share.s3.amazonaws.com/cat.jpg",
"predictions": [
{
"class_title": "cat",
"order": 1
}
],
"prediction_type": "image"
}
The response fields are:
# Object Detection with Image Url
import requests
import json
url = 'https://api.chooch.ai/predict/object_detection/?url=https://choochdashboard.s3.amazonaws.com/truck.jpg&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19c&model_id=88'
response = requests.post(url)
json_data = json.loads(response.content)
print(json_data)
var settings = {
"url": "https://api.chooch.ai/predict/object_detection/?url=https://choochdashboard.s3.amazonaws.com/truck.jpg&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19c&model_id=88",
"method": "GET",
"timeout": 0,
};
$.ajax(settings).done(function (response) {
console.log(response);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.chooch.ai/predict/object_detection/?url=https://choochdashboard.s3.amazonaws.com/truck.jpg&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19c&model_id=88",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
} ?>
curl --location --request GET "https://api.chooch.ai/predict/object_detection/?url=https://choochdashboard.s3.amazonaws.com/truck.jpg&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19c&model_id=88"
import requests
import json
import time
url = 'https://api.chooch.ai/predict/object_detection/?model_id=88&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19'
files = {'image': open('local_image.jpg', 'rb')}
response = requests.post(url, files=files)
json_data = json.loads(response.content)
print(json_data)
var form = new FormData();
form.append("image", "local_file");
var settings = {
"url": "https://api.chooch.ai/predict/object_detection/?model_id=88&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19",
"method": "POST",
"timeout": 0,
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.chooch.ai/predict/object_detection/?model_id=88&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => array('image'=> new CURLFILE('local_file')),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
} ?>
curl --location --request POST "https://api.chooch.ai/predict/object_detection/?model_id=88&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19" --form "image=@local_file"
{
"status": "ok",
"prediction_type": "object_detection",
"predictions": [
{
"class_title": "person",
"model_id": 88,
"score": 0.74613,
"coordinates": {
"xmin": 0,
"ymin": 35,
"ymax": 297,
"xmax": 179
}
}
]
}
API input fields are:
Chooch Face Recognition consists of Perception > People > Images
You can search and tag a face in the Chooch API by feeding the Chooch API a Face Image. Below
is a
sample post of an image url.
The fields are:
You can also post an image through the image field. Below are 2 separate sample posts in python.
import requests
import json
import time
url = 'https://api.chooch.ai/predict/face?url=https://choochdashboard.s3.amazonaws.com/base_site/1461123713-esq050116cover001s.jpg&person_id_filter=-1&model_id=14&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19'
response = requests.post(url)
json_data = json.loads(response.content)
print(json_data)
var form = new FormData();
var settings = {
"url": "https://api.chooch.ai/predict/face?url=https://choochdashboard.s3.amazonaws.com/base_site/1461123713-esq050116cover001s.jpg&person_id_filter=-1&model_id=14&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19",
"method": "POST",
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.chooch.ai/predict/face?url=https://choochdashboard.s3.amazonaws.com/base_site/1461123713-esq050116cover001s.jpg&person_id_filter=-1&model_id=14&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
} ?>
curl --location --request POST "https://api.chooch.ai/predict/face?url=https://choochdashboard.s3.amazonaws.com/base_site/1461123713-esq050116cover001s.jpg&person_id_filter=-1&model_id=14&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19"
import requests
import json
import time
url = 'https://api.chooch.ai/predict/face?person_id_filter=-1&model_id=5&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19'
files = {'image': open('local_image.jpg', 'rb')}
response = requests.post(url, files=files)
json_data = json.loads(response.content)
print(json_data)
var form = new FormData();
form.append("image", "");
var settings = {
"url": "https://api.chooch.ai/predict/face?person_id_filter=-1&model_id=14&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19",
"method": "POST",
"timeout": 0,
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.chooch.ai/predict/face?person_id_filter=-1&model_id=14&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => array('image'=> new CURLFILE('')),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
} ?>
curl --location --request POST "https://api.chooch.ai/predict/face?person_id_filter=-1&model_id=14&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19" --form "image=@"
import java.io.File;
import kong.unirest.HttpResponse;
import kong.unirest.JsonNode;
import kong.unirest.Unirest;
public class Test {
public static void main(String[] args) {
HttpResponse<JsonNode> response = Unirest.post("https://api.chooch.ai/predict/face?person_id_filter=-1&model_id=5&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19").field("image", new File("/home/ashwmadhu/Desktop/12.jpg")).asJson();
System.out.println(response.getBody());
}
}
using System;
using RestSharp;
namespace TestProject
{
class Program
{
static void Main(string[] args)
{
var client = new RestClient("https://api.chooch.ai/predict/face?person_id_filter=-1&model_id=5&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19");
var request = new RestRequest(Method.POST);
var path = "/home/ashwmadhu/Desktop/12.jpg";
request.AddFile("image", path);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
}
}
}
The example JSON response is here below. In this example, the similarity is 0.80. The face_recog_hit is True when there is a match and False when there is no match.
{
status: "ok",
person_id_filter: -1,
faces_detected: [
{
person_name: "George Clooney",
similarity: 0.8,
coordinates: "1402,1657,158,506",
image_url: "https://s3.amazonaws.com/choochdashboard/media/face_models/14/George_Clooney/220px-George_Clooney_2016_(1).jpg",
person_id: 22,
key_id: null
}
],
face_recog_hit: true,
face_count: 1,
post_type: "face_search",
faces: [
{
person_name: "George Clooney",
similarity: 0.8,
face_live: null,
coordinates: "1402,1657,158,506",
person_id: 22,
key_id: null,
face_live_status_description: null
}
],
similar_faces: [
{
person_name: "George Clooney",
similarity: 0.8,
coordinates: "1402,1657,158,506",
image_url: "https://s3.amazonaws.com/choochdashboard/media/face_models/14/George_Clooney/220px-George_Clooney_2016_(1).jpg",
person_id: 22,
key_id: null,
order: 1
},
{
person_name: "4566",
similarity: 0.8,
coordinates: "1402,1657,158,506",
image_url: "https://s3.amazonaws.com/choochdashboard/media/face_models/api/-1/79db335f-46e8-4e35-b15e-5174a5bc7d22.jpg",
person_id: 131,
key_id: "4566",
order: 2
},
{
person_name: "5677",
similarity: 0.08,
coordinates: "1402,1657,158,506",
image_url: "https://s3.amazonaws.com/choochdashboard/media/face_models/api/None/9f7eff07-6313-461b-b326-1a1949138244.jpg",
person_id: 130,
key_id: "5677",
order: 3
},
{
person_name: "Hakan Gultekin",
similarity: 0.07,
coordinates: "1402,1657,158,506",
image_url: "https://s3.amazonaws.com/choochdashboard/media/face_models/14/Hakan_Gultekin/37592577_10155843376073845_3443616404685717504_n.jpg",
person_id: 117,
key_id: null,
order: 4
}
]
}
This API function allows the user to add a face image with a unique id (it can be a unique person name, or a unique id assigned to a person):
import requests
import json
import time
url = 'https://api.chooch.ai/predict/face?&key_id=3245&model_id=7&command=insert_person_image_key_id&apikey=46g5717-1sd3-35h6-9104-b8h5c819dn19'
files = {'image': open('/home/ashwmadhu/Desktop/12.jpg', 'rb')}
response = requests.post(url, files=files)
json_data = json.loads(response.content)
print(json_data)
var form = new FormData();
form.append("image", "");
var settings = {
"url": "https://api.chooch.ai/predict/face?&key_id=3245&model_id=7&command=insert_person_image_key_id&apikey=46g5717-1sd3-35h6-9104-b8h5c819dn19",
"method": "POST",
"timeout": 0,
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.chooch.ai/predict/face?&key_id=3245&model_id=7&command=insert_person_image_key_id&apikey=46g5717-1sd3-35h6-9104-b8h5c819dn19",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => array('image'=> new CURLFILE('')),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
} ?>
curl -X POST 'https://api.chooch.ai/predict/face?key_id=3245&model_id=7&command=insert_person_image_key_id&apikey=46g5717-1sd3-35h6-9104-b8h5c819dn19' -F image=@/home/ashwmadhu/Desktop/12.jpg
import java.io.File;
import kong.unirest.HttpResponse;
import kong.unirest.JsonNode;
import kong.unirest.Unirest;
public class Test {
public static void main(String[] args) {
HttpResponse<JsonNode> response = Unirest.post("https://api.chooch.ai/predict/face?&key_id=3245&model_id=7&command=insert_person_image_key_id&apikey=46g5717-1sd3-35h6-9104-b8h5c819dn19").field("image", new File("/home/ashwmadhu/Desktop/12.jpg")).asJson();
System.out.println(response.getBody());
}
}
using System;
using RestSharp;
namespace TestProject
{
class Program
{
static void Main(string[] args)
{
var client = new RestClient("https://api.chooch.ai/predict/face?&key_id=3245&model_id=7&command=insert_person_image_key_id&apikey=46g5717-1sd3-35h6-9104-b8h5c819dn19");
var request = new RestRequest(Method.POST);
var path = "/home/ashwmadhu/Desktop/12.jpg";
request.AddFile("image", path);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
}
}
}
{
"status_description":"success",
"post_type":"insert_person_image",
"status":41868
}
You can create a person through the Chooch API. Below is a sample Python based usage of the create_person command.
# Create Person Python Code
import requests
import json
url = 'https://api.chooch.ai/predict/face?person_name=Tom Bill&model_id=5&apikey=cx065e5d-51wc87-9df6-163e-8b65a78k51e3&command=create_person'
response = requests.post(url)
json_data = json.loads(response.content)
print(json_data)
var form = new FormData();
var settings = {
"url": "https://api.chooch.ai/predict/face?person_name=Tom Bill&model_id=5&apikey=cx065e5d-51wc87-9df6-163e-8b65a78k51e3&command=create_person",
"method": "POST",
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.chooch.ai/predict/face?person_name=Tom%20Bill&model_id=5&apikey=cx065e5d-51wc87-9df6-163e-8b65a78k51e3&command=create_person",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
} ?>
curl --location --request POST "https://api.chooch.ai/predict/face?person_name=Tom%20Bill&model_id=5&apikey=cx065e5d-51wc87-9df6-163e-8b65a78k51e3&command=create_person"
import java.io.File;
import kong.unirest.HttpResponse;
import kong.unirest.JsonNode;
import kong.unirest.Unirest;
public class Test {
public static void main(String[] args) {
HttpResponse<JsonNode> response = Unirest.post("https://api.chooch.ai/predict/face?person_name=Tom&model_id=5&apikey=cx065e5d-51wc87-9df6-163e-8b65a78k51e3&command=create_person").asJson();
System.out.println(response.getBody());
}
}
using System;
using RestSharp;
namespace TestProject
{
class Program
{
static void Main(string[] args)
{
var client = new RestClient("https://api.chooch.ai/predict/face?person_name=Tom%20Bill&model_id=5&apikey=cx065e5d-51wc87-9df6-163e-8b65a78k51e3&command=create_person");
var request = new RestRequest(Method.POST);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
}
}
}
{
person_id: 37,
status: 37,
status_description: success,
post_type: create_person
}
A face image can be added to an existing person using the person_id. Below is a sample Python based usage of the insert_person_image command.
# Add face image to person with person_id_filter (person_id) Python Code
import requests
import json
url = 'https://api.chooch.ai/predict/face?person_id_filter=37&apikey=cx065e5d-51wc87-9df6-163e-8b65a78k51e3&command=insert_person_image'
files = {'image': open('your_image.jpg', 'rb')}
response = requests.post(url, files=files)
json_data = json.loads(response.content)
print(json_data)
var form = new FormData();
form.append("image", "");
var settings = {
"url": "https://api.chooch.ai/predict/face?person_id_filter=37&apikey=cx065e5d-51wc87-9df6-163e-8b65a78k51e3&command=insert_person_image",
"method": "POST",
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.chooch.ai/predict/face?person_id_filter=37&apikey=cx065e5d-51wc87-9df6-163e-8b65a78k51e3&command=insert_person_image",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => array('image'=> new CURLFILE('')),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
} ?>
curl --location --request POST "https://api.chooch.ai/predict/face?person_id_filter=37&apikey=cx065e5d-51wc87-9df6-163e-8b65a78k51e3&command=insert_person_image" --form "image=@"
{
status: 210,
status_description: success,
post_type: insert_person_image
}
The Chooch Facial Authentication API is a video/stream post API which Authenticates a Face in video based on a reference Face Image.
The API takes 2 parameters, a Video Url and an Image Url. Chooch Indexes the video and tries to Authenticate the Face in the video based on the reference face image.
At the end of the indexing Chooch returns a result in the “result” field, “live” or “not-live”.
If the face_live_result is “live” and “is_match_result” is “true” the Face in the input image matches the Face in the video and the Face in the video is live.
If the result is “not-live” and/or “is_match_result” is “false” the Face in the input image does not match the Face in the video and/or the Face in the video is not live.
The file_id returned in the posting of the video is used to query the status and result of the Authentication.
Below are details on how to use the API:
Note: Maximum allowed video length is 15 seconds.
{
status: "Waiting to be processed",
video_url: "https://chooch-share.s3.amazonaws.com/live-detection/Hakan_real.mp4",
image_url: "https://chooch-share.s3.amazonaws.com/live-detection/Hakan_1.jpg",
file_id: "24fd36c9-f804-4a56-af0d-34406504d3b8",
is_match_result: false,
face_live_result: "Waiting to be processed",
post_type: "face_live_detection"
}
The response fields are:
The initial post will return a file_id. This will be used to query the status result of the Face Authentication of the video.
import requests
import json
import time
url = 'https://api.chooch.ai/predict/face?url=https://choochdashboard.s3.amazonaws.com/base_site/1461123713-esq050116cover001s.jpg&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19&command=face_detect'
response = requests.post(url)
json_data = json.loads(response.content)
print(json_data)
var settings = {
"url": "https://api.chooch.ai/predict/face?url=https://choochdashboard.s3.amazonaws.com/base_site/1461123713-esq050116cover001s.jpg&command=face_detect&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19",
"method": "GET",
"timeout": 0,
};
$.ajax(settings).done(function (response) {
console.log(response);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.chooch.ai/predict/face?url=https://choochdashboard.s3.amazonaws.com/base_site/1461123713-esq050116cover001s.jpg&command=face_detect&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
} ?>
curl --location --request GET "https://api.chooch.ai/predict/face?url=https://choochdashboard.s3.amazonaws.com/base_site/1461123713-esq050116cover001s.jpg&command=face_detect&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19"
import requests
import json
import time
url = 'https://api.chooch.ai/predict/face?apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19&command=face_detect'
files = {'image': open('local_image.jpg', 'rb')}
response = requests.post(url, files=files)
json_data = json.loads(response.content)
print(json_data)
var form = new FormData();
form.append("image", "local_file");
var settings = {
"url": "https://api.chooch.ai/predict/face?person_id_filter=-1&model_id=5&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19&face_live=1",
"method": "POST",
"timeout": 0,
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.chooch.ai/predict/face?person_id_filter=-1&model_id=5&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19&face_live=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => array('image'=> new CURLFILE('local_file')),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
} ?>
curl --location --request POST "https://api.chooch.ai/predict/face?command=face_detect&apikey=346g5717-1sd3-35h6-9104-b8h5c819dn19" --form "image=@local_file"
{
face_count: 1,
post_type: "face_detection",
faces_detected:
[
{
confidence: 0.9999940395355225,
order: 1,
coordinates:
{
xmin: 1402,
ymin: 158,
ymax: 506,
xmax: 1657
}
}
]
}
The response fields are:
{
status: "Indexing Complete",
video_url: "https://chooch-share.s3.amazonaws.com/live-detection/Hakan_real.mp4",
image_url: "https://chooch-share.s3.amazonaws.com/live-detection/Hakan_1.jpg",
file_id: "ec5e7dbe-23ea-41bb-b846-25394193e7fe",
is_match_result: true,
face_live_result: "live",
post_type: "face_live_detection"
}
The response fields are:
{
status: "Indexing Complete",
video_url: "https://chooch-share.s3.amazonaws.com/live-detection/Hakan_1_fake_2.mp4",
image_url: "https://chooch-share.s3.amazonaws.com/live-detection/Hakan_1.jpg",
file_id: "131f6c1f-a889-4049-89cf-b7cd53708246",
is_match_result: true,
face_live_result: "not-live",
post_type: "face_live_detection"
}
The response fields are:
{
status: "Indexing Complete",
video_url: "https://chooch-share.s3.amazonaws.com/live-detection/Hakan_real.mp4",
image_url: "https://chooch-share.s3.amazonaws.com/live-detection/Hakan_1.jpg",
file_id: "ec5e7dbe-23ea-41bb-b846-25394193e7fe",
is_match_result: true,
face_live_result: "live",
post_type: "face_live_detection"
}
The response fields are:
import requests
import json
import time
video_url = https://chooch-share.s3.amazonaws.com/live-detection/Hakan_real.mp4
# fake video test if you want
# video_url = https://chooch-share.s3.amazonaws.com/live-detection/Hakan_1_fake_2.mp4
image_url = "https://chooch-share.s3.amazonaws.com/live-detection/Hakan_1.jpg"
api_key = "346g5717-1sd3-35h6-9104-b8h5c819dn19"
url = "https://api.chooch.ai/predict/live_detect/?video_url={}&image_url={}&apikey={}".format(video_url, image_url, api_key)
response = requests.post(url)
json_data = json.loads(response.content)
print(json_data)
{
status: "Waiting to be processed",
video_url: "https://chooch-share.s3.amazonaws.com/live-detection/Hakan_real.mp4",
image_url: "https://chooch-share.s3.amazonaws.com/live-detection/Hakan_1.jpg",
file_id: "24fd36c9-f804-4a56-af0d-34406504d3b8",
is_match_result: false,
face_live_result: "Waiting to be processed",
post_type: "face_live_detection"
}
The response fields are:
import requests
import json
import time
file_id = "8726799d-ec23-450c-a229-ccdc543b2d5e"
api_key = "346g5717-1sd3-35h6-9104-b8h5c819dn19"
url = "https://api.chooch.ai/predict/live_detect/?file_id={}&apikey={}".format(file_id, api_key)
response = requests.post(url)
json_data = json.loads(response.content)
print(json_data)
{
status: "Indexing Complete",
video_url: "https://chooch-share.s3.amazonaws.com/live-detection/Hakan_real.mp4",
image_url: "https://chooch-share.s3.amazonaws.com/live-detection/Hakan_1.jpg",
file_id: "ec5e7dbe-23ea-41bb-b846-25394193e7fe",
is_match_result: true,
face_live_result: "live",
post_type: "face_live_detection"
}
The response fields are:
Chooch provides a Facial Recognition Perception training platform to train your own face images. Below is a summary on how to train and test a Facial Recognition Perception.
https://app.chooch.ai
If you don’t have an account simply sign
up.
After logging into the Chooch Dashboard click on the Training tab. The Training options
will appear as seen below:
There are 3 options of training on the screen: Facial, Image and Object.
Select “Facial”. The Facial Recognition Perceptions screen will
appear as seen below:
You can create and manage your Facial Recognition Perceptions from this screen.
Let’s create a new perception named “Famous People”. We click on “Create Perception” and
type in “Famous People” as seen below:
After the Perception is created the Perception Detail Screen will appear as seen below:
Let’s add a Person to the perception.
As seen below we add “George Clooney” to the perception.
After we add a person the “Person Detail” page will appear. We recommend at least 5
face photos for each person in order to get high quality results.
Let’s add images to the Person (George Clooney). We can select and upload multiple images
as seen below.
Now that we added our images we can test our Perception. Let’s click on back and go to the
Perception detail screen.
After we enabled our Perception and added a person we can start testing.
Click on “Predict via Upload” and select an image. Below we uploaded an image of “George Clooney” that was not in the dataset. We got a similarity score of 0.80 which means this person is most likely George Clooney. Anything above 0.70 is considered a match.
There is also a search function to search people in the Perceptions.
On the Settings tab of the Dashboard you will see your API key. Please refer to
the Facial Recognition API documentation on how to predict faces using the Chooch API.
More coming soon.
