Last 7 days, UTC

Average Latency
94ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time

Simple & Straightforward Pricing

Pay as you go. No long-term contracts.

Freemium

$0

additional fees may apply

DETECT

100 / mo.

$0.2500 per extra

RECOGNIZE

30 / mo.

$0.2500 per extra

50 Entries Per Album Recognize up to 50 different entry types per album (e.g. 50 unique celebs in a celebs album).

Subscribe

basic

$19.00

per month

DETECT

10,000 / mo.

$0.1500 per extra

RECOGNIZE

1,000 / mo.

$0.2000 per extra

50 Entries Per Album Recognize up to 50 different entry types per album (e.g. 50 unique celebs in a celebs album).

Subscribe

ultra

$256.00

per month

DETECT

200,000 / mo.

$0.0500 per extra

RECOGNIZE

30,000 / mo.

$0.0500 per extra

50 Entries Per Album Recognize up to 50 different entry types per album (e.g. 50 unique celebs in a celebs album).

Subscribe

Endpoints

HTTP 200 : Train Response GET/album_train
The response after you add an entry to an album
						{
  "album": "CELEBS",
  "image_count": 5,
  "entryid": "TigerWoods"
}						
View Entry

View an entry in an album, telling you how many training images it has


Test console
Description
Parameter
string

The name of the album
Example: CELEBS

album

Required

string

The album key for the album
Example: b1ccb6caa8cefb7347d0cfb65146d5e3f84608f6ee55b1c90d37ed4ecca9b273

albumkey

Required

string

An entry id for the person you with to view
Example: TigerWoods

entryid

Required

Detect & Recognize

HTTP 200 : Photoset Response POST/detect
A set of photos and the tags within them
						{
  "status": "success",
  "photos": [
    {
      "url": "http://www.lambdal.com/tiger.jpg",
      "width": 600,
      "tags": [
        {
          "eye_left": {
            "y": 116,
            "x": 357
          },
          "confidence": 0.978945010372561,
          "center": {
            "y": 130,
            "x": 339
          },
          "mouth_right": {
            "y": 119,
            "x": 341
          },
          "mouth_left": {
            "y": 119,
            "x": 288
          },
          "height": 140,
          "width": 140,
          "mouth_center": {
            "y": 119,
            "x": 314.5
          },
          "nose": {
            "y": 147,
            "x": 336
          },
          "eye_right": {
            "y": 115,
            "x": 314
          },
          "tid": "31337",
          "attributes": [
            {
              "gender": "male",
              "confidence": 59
            }
          ],
          "uids": [
            {
              "confidence": 0.742,
              "prediction": "TigerWoods",
              "uid": "TigerWoods@CELEBS"
            },
            {
              "confidence": 0.161,
              "prediction": "ArnoldS",
              "uid": "ArnoldS@CELEBS"
            },
            {
              "confidence": 0.065,
              "prediction": "JenniferAniston",
              "uid": "JenniferAniston@CELEBS"
            }
          ]
        }
      ],
      "height": 585
    }
  ]
}						
Detect

Detect faces in an image, as well as extract facial features (eyes, nose, mouth)


Test console
Description
Parameter
binary

A set of binary image files

files

Optional

string

A comma separated list of image URLs
Example: http://www.lambdal.com/test2.jpg

urls

Optional

HTTP 200 : Photoset Response POST/recognize
A set of photos and the tags within them
						{
  "status": "success",
  "photos": [
    {
      "url": "http://www.lambdal.com/tiger.jpg",
      "width": 600,
      "tags": [
        {
          "eye_left": {
            "y": 116,
            "x": 357
          },
          "confidence": 0.978945010372561,
          "center": {
            "y": 130,
            "x": 339
          },
          "mouth_right": {
            "y": 119,
            "x": 341
          },
          "mouth_left": {
            "y": 119,
            "x": 288
          },
          "height": 140,
          "width": 140,
          "mouth_center": {
            "y": 119,
            "x": 314.5
          },
          "nose": {
            "y": 147,
            "x": 336
          },
          "eye_right": {
            "y": 115,
            "x": 314
          },
          "tid": "31337",
          "attributes": [
            {
              "gender": "male",
              "confidence": 59
            }
          ],
          "uids": [
            {
              "confidence": 0.742,
              "prediction": "TigerWoods",
              "uid": "TigerWoods@CELEBS"
            },
            {
              "confidence": 0.161,
              "prediction": "ArnoldS",
              "uid": "ArnoldS@CELEBS"
            },
            {
              "confidence": 0.065,
              "prediction": "JenniferAniston",
              "uid": "JenniferAniston@CELEBS"
            }
          ]
        }
      ],
      "height": 585
    }
  ]
}						
Recognize

Recognize the person in an image


Test console
Description
Parameter
string

The album you want to look in
Example: CELEBS

album

Required

string

Your album key
Example: b1ccb6caa8cefb7347d0cfb65146d5e3f84608f6ee55b1c90d37ed4ecca9b273

albumkey

Required

binary

A set of binary image files to recognize

files

Optional

string

A comma separated list of image URLs to recognize
Example: http://www.lambdal.com/tiger.jpg

urls

Optional

Image Management

HTTP 200 : Album Creation POST/album
The response when you create an album
						{
  "msg": "Please put this in a safe place and remember it, you'll need it!",
  "album": "example",
  "albumkey": "89466ebcb08649760cd9b05azf1a047f8bdfe0fbc033c499d6b982e9ae01f049"
}						
Create Album

Create a new photo album, be sure to save your albumkey!


Test console
Description
Parameter
string

The name of the album to create
Example: CELEBS

album

Required

HTTP 200 : Album Rebuild GET/album_rebuild
Response after rebuilding an album
						{
  "album": "CELEBS",
  "size": 6
}						
Rebuild Album

Manually rebuild an album after adding training examples


Test console
Description
Parameter
string

The name of the album to rebuild
Example: CELEBS

album

Required

string

The albumkey for the album to rebuild
Example: b1ccb6caa8cefb7347d0cfb65146d5e3f84608f6ee55b1c90d37ed4ecca9b273

albumkey

Required

HTTP 200 : Train Response POST/album_train
The response after you add an entry to an album
						{
  "album": "CELEBS",
  "image_count": 5,
  "entryid": "TigerWoods"
}						
Train Album

Add an image and entryid to an album


Test console
Description
Parameter
string

The name of the album
Example: CELEBS

album

Required

string

The album key for the album
Example: b1ccb6caa8cefb7347d0cfb65146d5e3f84608f6ee55b1c90d37ed4ecca9b273

albumkey

Required

string

An entry id for the person you are uploading pictures of
Example: TigerWoods

entryid

Required

binary

An image containing the person you are adding to the album

files

Optional

string

A comma separated list of image urls
Example: http://www.lambdal.com/tiger.jpg

urls

Optional

HTTP 200 : Train Response GET/album
The response after you add an entry to an album
						{
  "album": "CELEBS",
  "image_count": 5,
  "entryid": "TigerWoods"
}						
View Album

View one of your albums, with a visual summary.


Test console
Description
Parameter
string

The name of the album you want to view
Example: CELEBS

album

Required

string

The album key of the album you want to view
Example: b1ccb6caa8cefb7347d0cfb65146d5e3f84608f6ee55b1c90d37ed4ecca9b273

albumkey

Required

You must have an API key to test this API!


Mashape allows developers to find, consume, and distribute cloud APIs just like Face Recognition.

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.