Q: Why would the authentication fail?

InvalidParameters (400) Malformed JSON body or missing required fields: client_id, id_token. Wrong Content-Type header (must be application/json). InvalidAuthentication (401) Wrong client_id (not the API Key shown in console). Wrong id_token (must be produced by encrypting the exact plaintext client_id=<client_id>&timestamp=<timestamp in millisecond> using RSA X.509 with the Base64-encoded client_secret). Expired API key

Question 1

How can I create account and is it free to create accounts?

Accepted Answer

You can create accounts from the YouCam Online Editor website and account Registration is 100% free.

Question 2

What does “Unit” mean in this API?

Accepted Answer

Units are credits used exclusively for AI API usage (not UI credits). Each AI feature consumes units only when a task is successfully completed.

Question 3

Do you offer free units for trial usage?

Accepted Answer

When generate API KEY for the 1st time, system will offer 40 free units for trial purpose.

Question 4

How to obtain id_token, which will be used during the Authentication API call?

Accepted Answer

Create an API Key in the console — your API Key is client_id, and the Secret key is client_secret.
Create the exact string:
client_id=×tamp=
Then encrypt it with RSA X.509 using the Base64-encoded client_secret to obtain id_token

Question 5

Why would the authentication fail?

Accepted Answer

InvalidParameters (400)
- Malformed JSON body or missing required fields: client_id, id_token.
- Wrong Content-Type header (must be application/json).
InvalidAuthentication (401)
- Wrong client_id (not the API Key shown in console).
- Wrong id_token (must be produced by encrypting the exact plaintext client_id=×tamp= using RSA X.509 with the Base64-encoded client_secret).
- Expired API key

Question 6

Why do I get InvalidTaskId errors?

Accepted Answer

The task_id needs to be URL encoded before using it to call the get status API
After calling the run task API, please continue to call the get status API based on the polling_interval time returned in the get status API response. If does not keep polling the get status API, server may completed the result (which consumed the credits), but does not know how should grab it.
Please also note that the access_token is only valid for 2 hours, so please also ensure that the access_token is still valid.

Question 7

Does YouCam API provide before and after images for face detection?

Accepted Answer

Our API provides you with detection results, enabling your website to display result images to consumers that align with your official website or brand characteristics. If this doesn't meet your specific needs, please contact us to learn more about our Enterprise services.

Face Shapes and Ratio Analysis API

Leverage AI to scan and analyze 50+ facial features & 11 facial ratios. Restful API ensures the seamless integration into your website, mobile apps, e-commerce platforms & more.

Facial Features and Shapes Analysis API

Face Ratio Analyzer API for Developer

Accurate and Robust API Performance

Flexible Pricing Plans

Seamlessly API Integration Options

Get API Key & Start Building

Create an Account

Install the API

Start Monetizing

YouCam Online Editor API FAQs

JavaScript & Java

Flutter

Python

PHP

Node.js

curl