Facial Expressions

✴️ Controlling Your Avatar's Expressions

Creating engaging visuals is all about capturing the attention of the viewer. With D-ID's API, you can take your visuals to the next level by controlling the expressions of your avatar. Adding expressions to your avatar can make them more engaging, fun, and lifelike. This can help boost the engagement with your viewers and increase the overall enjoyment of your visuals.

✴️ Expressions in Action

✴️ Control Expressions of the Entire Video

To apply an expression to your avatar throughout the entire video, simply add a driver_expressions parameter under the config object of the API request body. For example:

POST https://api.d-id.com/talks | Create a talk

{
  "source_url": "https://myhost.com/image.jpg",
  "script": {
    "type": "text",
    "input": "Hello world!"
  },
  "config": {
    "driver_expressions": {
      "expressions": [
        {
          "start_frame": 0,
          "expression": "surprise",
          "intensity": 1
        }
      ]
    }
  }
}

{
    "id": "tlk_TMj4G1wiEGpQrdNFvrqAk",
    "created_at": "2023-03-22T16:38:49.723Z",
    "created_by": "google-oauth2|12345678",
    "status": "created",
    "object": "talk"
}

The driver_expressions parameter takes an array of objects, each containing the start_frame, expression, and intensity of the expression. To apply the same expression to the entire video add a single expression object and the start_frame of it to 0. Use the expression parameter to control the type of emotion to display, and intensity with a float value between 0 to 1.0 to control the intensity of the emotion.

✴️ Creating a Sequence of Expressions

You can also create a sequence of expressions by adding multiple expressions in the configuration object. For example, the following code snippet shows how you can set your avatar's expression to surprise at the start of the video, happy at frame 50, serious at frame 100, and back to neutral at frame 150. The transition between each expression will take 20 frames in order to create a smooth animation.
By changing the transition_frames argument you can control the smoothness of the transition between the different expressions. Example:

POST https://api.d-id.com/talks | Create a talk

{
  "source_url": "https://url.to.my/image.jpg",
  "config": {
     "driver_expressions": {
        "expressions": [
            {
                "start_frame": 0,
                "expression": "surprise",
                "intensity": 1.0
            },
            {
                "start_frame": 50,
                "expression": "happy",
                "intensity": 1.0
            },
            {
                "start_frame": 100,
                "expression": "serious",
                "intensity": 0.6
            },
            {
                "start_frame": 150,
                "expression": "neutral",
                "intensity": 1.0
            }
        ],
        "transition_frames": 20
    }
  },
  "script": {
    "type": "audio",
    "audio_url": "https://url.to.my/audio.mp3"
  }
}

✴️ Available Expressions

D-ID currently supports the following expressions:

✴️ Support

Have any questions? We are here to help! Please leave your question in the Discussions section and we will be happy to answer shortly.

Ask a question