Our Clients

 

Since 2007 we have been providing solutions to more than 70 clients worldwide, ranging from small startups to government bodies and global brands.

Portrait3D API

Portrait3D™ API takes an image as input and generates a photorealistic 3D avatar that can move and express emotions. 3D avatar can be published on a Web-page (requires Adobe® Flash® Player):


Portrait3D may be useful for various social applications, games and chat rooms to bring in power and features of 3D while maintaining photorealistic quality.

API Description

Portrait3D API can be accessed via Mashape.com. We offer several pricing plans, feel free to choose one that best fits your requirements. To use Portrait3D you simply have to sign up to a pricing plan and follow the instructions on using the API.

Source Image Restrictions

Portrait3D has some restrictions on source images:

  • Image Type: JPEG or PNG
  • Image Dimensions: 200×200 up to 4000×4000
  • Image File Size: 10 KBytes up to 5 MBytes

Images that don’t fit these requirements are rejected with HTTP Status Code 400.

Source Image Recommendations

To get best looking avatar, follow these simple recommendations:

  • Image should contain only one face
  • Best results are achieved on full face images with minimum rotation around the vertical axis
  • Image resolution should be high enough to produce high-quality avatar

In general: quality of the source photograph affects quality of the resulting avatar.

Passing Image URL

If your image is hosted somewhere, you may use the URL to create an avatar. URL should be passed in the 'url' parameter using GET method:

https://avatarion-portrait3d.p.mashape.com/create/?url={URL}

Note: {URL} string should be url-encoded.

Example (using cURL):

curl -H "X-Mashape-Authorization: {Your Mashape Authorization Code}" "https://avatarion-portrait3d.p.mashape.com/create/?url=http%3A%2F%2Favatarion.com%2Fimages%2Fharrison-ford.jpg" -k

POSTing Image File

Another option is to upload an image using POST request and the 'image' parameter. Example (using cURL):

curl -H "X-Mashape-Authorization: {Your Mashape Authorization Code}" "https://avatarion-portrait3d.p.mashape.com/create/" -F "image=@test.jpg;" -k

In this example 'test.jpg' is the actual image file to be uploaded.

API Response

Regardless of the chosen method, if no errors occur the API sets HTTP Status Code to 200 and returns JSON object in the response body:

{ "avatar" : "abc123" }

'abc123' is the Avatar ID that can be used to publish an avatar on a desired Web page (see below).

Error Handling

If something goes wrong the API sets HTTP Status Code to one of the following values:

  • 400 – indicates a problem with the provided image (wrong file type, size, URL does not exist, etc.)
  • 500 – indicates an internal API error. If this error persists please contact us.

Additionally, error details are passed in the response body in JSON format:

{ "error" : "INVALID_IMAGE_FILE_SIZE" }

Using Created Avatars

Created avatars can be published on a Web page using the following HTML code:

<iframe width="250" height="250" frameborder="0" src="http://content.avatarion.com/portrait3d/v1/embed/{Avatar ID}?emotion={Emotion}"></iframe>

{Avatar ID} is an ID of an avatar returned by the API.

The 'emotion' parameter sets the primary emotion, expressed by the avatar (optional). Currently we support the following emotions: neutral, smile, wink, sad and surprise.

Additionally you may change 'width' and 'height' attributes of the iframe tag.

Note: you can also use a secure connection for sites that work over SSL, just replace 'http' with 'https' in the <iframe> src attribute.

Example:

<iframe width="250" height="250" frameborder="0" src="http://content.avatarion.com/portrait3d/v1/embed/83kw36?emotion=wink"></iframe>

Or (if your site requires SSL):

<iframe width="250" height="250" frameborder="0" src="https://content.avatarion.com/portrait3d/v1/embed/83kw36?emotion=wink"></iframe>

Result:

Note: Portrait3D avatars currently require Adobe® Flash® Player 11.1 or later to be installed.