Eyedea Recognition

Documentation

REST Interafce

API uses REST-like interface. This means that all calls to the API are made over the Internet, using HTTP GET and POST requests to the API server (http://face.eyedea.cz/api). Any programming language that can be used to communicate over HTTP can be used for client-side implementations.

Photo can be uploaded directly in the API request. A requests that uploads a photo must be formed as a MIME multi-part message sent using POST data. Each argument, including the raw image data, should be specified as a separate chunk of form data. (See example below)

Responses are returned in JSON, YAML or XML formats.

API Methods

facedetect

usage notes:

All coordinates are provided in % values to support any photo scale. Photo width and height (vs. frame width/height) are provided in pixels.

The maximum image size you can treat with is 1MB.

url:

http://face.eyedea.cz/api

parameters: return values: error codes:
error_codeerror_message
20IMG_DECODE_ERROR
29UPLOAD_ERROR
31DOWNLOAD_ERROR_FILE_NOT_FOUND
33DOWNLOAD_ERROR_FILE_TOO_LARGE
34DOWNLOAD_ERROR_MALFORMED_URL
104INTERNAL_ERROR
204INVALID_LOGIN

get example:

http://face.eyedea.cz/api/facedetect.json?email=youremail&password=yourpassword&url=http://upload.wikimedia.org/wikipedia/commons/3/37/Kg-foto13.jpg

post example: (post to http://face.eyedea.cz/api/facedetect.json)

Content-Type: multipart/form-data; boundary=nonRelevantString
Content-Length: 104687
-----------------------------nonRelevantString
Content-Disposition: form-data; name="email"
youremail
-----------------------------nonRelevantString
Content-Disposition: form-data; name="password"
yourpassword
-----------------------------nonRelevantString
Content-Disposition: form-data; name="upload"; filename="image.jpg"
Content-Type: image/jpeg