Cartesia

Available for agents using V4 (Expressive) Avatars only

Example Usage

D-ID provides Cartesia integration to generate text to speech for agents using V4 Expressive Avatars.

⚪

V4 Expressive Avatar agents only

Cartesia voices can be used only when the agent presenter.type is expressive. Requests that use a Cartesia voice with a talk or clip presenter fail with a 400 error.

{
  "presenter": {
    "type": "expressive",
    "presenter_id": "YOUR_EXPRESSIVE_AVATAR_ID",
    "voice": {
      "type": "cartesia",
      "voice_id": "694f9389-aac1-45b6-b726-9d9369183238"
    }
  }
}
{
  "presenter": {
    "type": "expressive",
    "presenter_id": "YOUR_EXPRESSIVE_AVATAR_ID",
    "voice": {
      "type": "cartesia",
      "voice_id": "694f9389-aac1-45b6-b726-9d9369183238",
      "model_id": "sonic-3",
      "language": "en",
      "voice_config": {
        "rate": "1.2"
      }
    }
  }
}

Available Voices

Use the /voices endpoint with provider=cartesia to get all the supported Cartesia voices.

Voice Config

Speed: The rate parameter controls how fast the voice speaks. The value is relative to 1 (normal speed), for example "0.8" is slower and "1.2" is faster. Valid range is 0.6 to 1.5. Default value: 1. Speed control is supported by the Sonic 3 models and newer (sonic-3, sonic-3.5, sonic-3.6), not by sonic-2.

Model: The model_id parameter selects the Cartesia model. When omitted, the default Cartesia model is used.

Model namemodel_idModel description
Sonic 3.6sonic-3.6The latest model. Fastest and most natural speech, native support for 44 languages, supports the rate speed control.
Sonic 3.5sonic-3.5Previous Sonic 3 release, supports the rate speed control.
Sonic 3sonic-3First Sonic 3 release, supports the rate speed control.
Sonic 2sonic-2Deprecated. Does not support the rate speed control.

Dated snapshot ids such as sonic-3.6-2026-08-27 and the sonic-latest alias are accepted as well. Please visit the Cartesia models page for more information on all the available models

Language: The language parameter is the language of the selected voice in ISO 639-1 (2-letter) format, for example en.


What’s Next

Did this page help you?