expression
#
object
The expression
object defines the type and the intensity of your actor’s facial expression. The expression type is defined using a string, while the intensity is a float that ranges from 0 (neutral expression) to 1 (maximum intensity).
![]() Surprise (intensity 1)# |
![]() Disgust (intensity 0.75)# |
![]() Happiness (intensity 0.75)# |
![]() Anger (intensity 1)# |
![]() Neutral expression# |
![]() Fear (intensity 0.75)# |
![]() Mouth open (intensity 0.25)# |
![]() Sadness (intensity 0.5)# |
![]() Contempt (intensity 0.25)# |
The expression
object contains the following fields:
"expression": { "name": //The type of expression, such as happiness or disgust. "intensity": //The intensity of the expression, from 0 to 1. }
Sample usage
Location in the data request
In the JSON hierarchy of the data request, the
expression
field is found here:{ "datapoints": [ { "human": { "expression": { } } } ] }
A sample complete expression object
"expression": { "name": "contempt", "intensity": 0.5 }These values will generate a facial expression that looks like this:
![]()
name
#
string
The name
field defines the type of expression that your actor will be wearing on their face.
![]()
|
![]()
|
![]()
|
![]()
|
![]()
|
![]()
|
![]()
|
![]()
|
![]()
|
Sample usage
A sample name field and its location in the data request
In the JSON hierarchy of the data request, the name
field is found here:
{ "datapoints": [ { "human": { "expression": { "name": "happiness", } } } ] }
This value will generate an actor with a happy expression:

intensity
#
Float
The intensity
field defines the intensity of the actor’s facial expression from 0 (neutral expression) to 1 (full intensity). The intensity will be applied to the facial expression (happiness, surprise, etc.) that you defined in the name field above.
Here are examples of how the facial expression scales up as it moves from 0 to 1:
Note
In all cases, an expression of intensity 0 is indistinguishable from a neutral expression; we recommend you use a minimum intensity of 0.1.
Contempt
Happiness
Mouth open
Surprise
Sample usage
A sample intensity field and its location in the data request
In the JSON hierarchy of the data request, the intensity
field is found here:
{ "datapoints": [ { "human": { "expression": { "intensity": 5, } } } ] }
This value will generate an actor with a very intense expression - in this case, disgust:
