Cortex API
Search
K

facialExpressionThreshold

This method can get or set the threshold of a facial expression action for a specific profile.
Actions with a low threshold are less likely to be detected. Actions with a high threshold will be detected more often.

Parameters

Name
Type
Required
Description
cortexToken
string
yes
A token returned by authorize.
status
string
yes
Must be "get" or "set".
action
string
yes
You get or set the threshold for this action.
profile
string
no
A profile name.
session
string
no
A session id returned by createSession.
value
number
no
If the status is "set", this parameter must be a number between 0 and 1000. This will be the new threshold of the action.
You must set one of these 2 parameters: profile or session. Read this for details.

Result

If the status is "get", then the result is a number that is the current threshold of the action. If the status is "set", then the result is a string that is a success message.

Examples

Get

Request
Response
{
"id": 1,
"jsonrpc": "2.0",
"method": "facialExpressionThreshold",
"params": {
"action": "blink",
"cortexToken": "xxx",
"session": "1d5d3655-d570-4731-9faf-967bc5440dc5",
"status": "get"
}
}
{
"id":1,
"jsonrpc":"2.0",
"result":500
}

Set

Request
Response
{
"id": 2323514,
"jsonrpc": "2.0",
"method": "facialExpressionThreshold",
"params": {
"action": "surprise",
"cortexToken": "xxx",
"session": "1d5d3655-d570-4731-9faf-967bc5440dc5",
"status": "set",
"value": 703
}
}
{
"id": 2323514,
"jsonrpc": "2.0",
"result": "success"
}