API Reference

Clips Overview 📙

✴️ Clips Overview


 Enabling FULL-HD photorealistic avatars, medium-shot, with body and hands movements using just text or audio as input. Premium+ Presenters (Clips) is an easy-to-use endpoint that lets users and developers supercharge training presentations, corporate communications, sales, marketing content and more. You can also create a custom HQ Presenter in Full-HD resolution based on your own video footage.

✴️ Interface

Input
Premium Presenter + Text or Audio file URL Output
Video URL


Presenter ID Text / Audio Video

✴️ Example #1: Default Call

POST https://api.d-id.com/clips | Create a clip 

{
    "script": {
        "type": "text",
        "input": "Hello world!"
    },
    "presenter_id": "v2_public_Amber@0zSz8kflCN"
}

{
    "id": "clp_auvOUSOANX95VaLCKb2Il",
    "created_at": "2023-03-22T21:33:52.454Z",
    "object": "clip",
    "status": "created"
}

GET https://api.d-id.com/clips/<id> | Get a specific clip 

Empty request body
See the Response tab

{
    "metadata": {
        "num_frames": 41,
        "processing_fps": 15.429858021131948,
        "resolution": [
            1920,
            1080
        ],
        "size_kib": 189.255859375
    },
    "audio_url": "https://d-id-clips-prod.s3.us-west-2.amazonaws.com/google-oauth2%7C10396q34341765131871486/clp_auvOUSOANX95VaLCKb2Il/microsoft.wav?AWSAccessKeyId=AKIA5SDFDSFIJ7CPKJNP&Expires=1679607232&Signature=%2Fo97jLpizsFfunCJKjEseb8OsPE%3D",
    "created_at": "2023-03-22T21:33:52.454Z",
    "config": {
        "logo": {
            "url": "ai",
            "position": [
                0,
                0
            ]
        },
        "result_format": ".mp4"
    },
    "source_url": "https://clips-presenters.d-id.com/amy/jcwCkr1grs/uM00QMwJ9x/thumbnail.png",
    "created_by": "google-oauth2|12345678",
    "status": "done",
    "driver_id": "uM00QMwJ9x",
    "modified_at": "2023-03-22T21:34:01.025Z",
    "completed_at": "2023-03-22T21:34:00.924",
    "presenter_id": "amy-jcwCkr1grs",
    "result_url": "https://d-id-clips-prod.s3.us-west-2.amazonaws.com/google-oauth2%7C1039658317634543586/clp_auvOUSOADFGDFKb2Il/amy-jcwCkr1grs.mp4?AWSAccessKeyId=AKIA5CUMPJBIJ7CPKJNP&Expires=1679607241&Signature=UjgamgTtNfSNL2IUiOOMSMBOI0U%3D",
    "id": "clp_auvOUSOANX95VaLCKb2Il",
    "duration": 2,
    "started_at": "2023-03-22T21:33:52.978",
    "owner_id": "google-oauth2|12345678"
}

The output video is located in the result_url field.

📘

Note

The output video is ready only when "status": "done"

status field lifecycle:

"status": "created"When posting a new clips request
"status": "started"When starting the video processing
"status": "done"When the video is ready

Default presenters list:

Avatar's Namepresenter_id
Amberv2_public_Amber@0zSz8kflCN
Adamv2_public_Adam@0GLJgELXjc

👍

Full Presenters list

In order to get the most updated presenters list, you should make a call to /clips/presenters endpoint

Get Presenters endpoint also contains video examples of the presenters

GET https://api.d-id.com/clips/presenters | Get presenters list 

Empty request body
See the Response tab

{
			"presenter_id": "v2_public_Amber@0zSz8kflCN",
			"gender": "female",
			"name": "Amber",
			"preview_url": "https://clips-presenters.d-id.com/v2/Amber/0zSz8kflCN/OUM7xZOuD5/preview.mp4",
			"modified_at": "2025-08-26T07:54:36.741Z",
			"owner_id": "PUBLIC_D-ID",
			"thumbnail_url": "https://clips-presenters.d-id.com/v2/Amber/0zSz8kflCN/OUM7xZOuD5/thumbnail.png",
			"image_url": "https://clips-presenters.d-id.com/v2/Amber/0zSz8kflCN/OUM7xZOuD5/image.png",
			"talking_preview_url": "https://clips-presenters.d-id.com/v2/Amber/0zSz8kflCN/OUM7xZOuD5/talkingPreview.mp4",
			"idle_video": "https://clips-presenters.d-id.com/v2/Amber/0zSz8kflCN/OUM7xZOuD5/idle.mp4?cache_busting=2025-08-26T07:54:36.741Z",
			"created_at": "2025-08-26T07:54:36.741Z",
			"voice": {
				"type": "elevenlabs",
				"voice_id": "Dimf6681ffz3PTVPPAEX"
			},
			"is_streamable": true,
			"status": "done"
},
{
			"presenter_id": "v2_public_Adam@0GLJgELXjc",
			"gender": "male",
			"name": "Adam",
			"preview_url": "https://clips-presenters.d-id.com/v2/Adam/0GLJgELXjc/j0HIbyxjap/preview.mp4",
			"modified_at": "2025-08-26T15:42:23.445Z",
			"owner_id": "PUBLIC_D-ID",
			"thumbnail_url": "https://clips-presenters.d-id.com/v2/Adam/0GLJgELXjc/j0HIbyxjap/thumbnail.png",
			"image_url": "https://clips-presenters.d-id.com/v2/Adam/0GLJgELXjc/j0HIbyxjap/image.png",
			"talking_preview_url": "https://clips-presenters.d-id.com/v2/Adam/0GLJgELXjc/j0HIbyxjap/talkingPreview.mp4",
			"idle_video": "https://clips-presenters.d-id.com/v2/Adam/0GLJgELXjc/j0HIbyxjap/idle.mp4?cache_busting=2025-08-26T15:42:23.445Z",
			"created_at": "2025-08-26T15:42:23.445Z",
			"voice": {
				"type": "elevenlabs",
				"voice_id": "U6LxHR0vu0MhG5Nqp5ID"
			},
			"is_streamable": true,
			"status": "done"
},

  And many more!

✴️ Example #2: Webhooks

Simply create an endpoint on your side and add it in the webhook field.
Then the webhook endpoint will be triggered with the same response body once the video is ready.

POST https://api.d-id.com/clips | Create a clip 

{
    "script": {
        "type": "text",
        "input": "Hello world!"
    },
    "presenter_id": "v2_public_Amber@0zSz8kflCN",
    "webhook": "https://myhost.com/webhook"
}

{
    "id": "clp_auvOUSOANX95VaLCKb2Il",
    "created_at": "2023-03-22T21:33:52.454Z",
    "object": "clip",
    "status": "created"
}

{
    "metadata": {
        "num_frames": 41,
        "processing_fps": 15.429858021131948,
        "resolution": [
            1920,
            1080
        ],
        "size_kib": 189.255859375
    },
    "audio_url": "https://d-id-clips-prod.s3.us-west-2.amazonaws.com/google-oauth2%7C10396q34341765131871486/clp_auvOUSOANX95VaLCKb2Il/microsoft.wav?AWSAccessKeyId=AKIA5SDFDSFIJ7CPKJNP&Expires=1679607232&Signature=%2Fo97jLpizsFfunCJKjEseb8OsPE%3D",
    "created_at": "2023-03-22T21:33:52.454Z",
    "config": {
        "logo": {
            "url": "ai",
            "position": [
                0,
                0
            ]
        },
        "result_format": ".mp4"
    },
    "source_url": "https://clips-presenters.d-id.com/amy/jcwCkr1grs/uM00QMwJ9x/thumbnail.png",
    "created_by": "google-oauth2|12345678",
    "status": "done",
    "driver_id": "uM00QMwJ9x",
    "modified_at": "2023-03-22T21:34:01.025Z",
    "completed_at": "2023-03-22T21:34:00.924",
    "presenter_id": "amy-jcwCkr1grs",
    "result_url": "https://d-id-clips-prod.s3.us-west-2.amazonaws.com/google-oauth2%7C1039658317634543586/clp_auvOUSOADFGDFKb2Il/amy-jcwCkr1grs.mp4?AWSAccessKeyId=AKIA5CUMPJBIJ7CPKJNP&Expires=1679607241&Signature=UjgamgTtNfSNL2IUiOOMSMBOI0U%3D",
    "id": "clp_auvOUSOANX95VaLCKb2Il",
    "duration": 2,
    "started_at": "2023-03-22T21:33:52.978",
    "owner_id": "google-oauth2|12345678"
}

✴️ Example #3: Text to Speech

Choose different voices, languages, and styles. See the supported Text-to-Speech providers' voices list

POST https://api.d-id.com/clips | Create a clip 

{
    "script": {
        "type": "text",
        "input": "Hello world!",
        "provider": {
            "type": "microsoft",
            "voice_id": "en-US-JennyNeural",
            "voice_config": {
                "style": "Cheerful"
            }
        }
    },
    "presenter_id": "v2_public_Amber@0zSz8kflCN"
}

{
    "id": "clp_auvOUSOANX95VaLCKb2Il",
    "created_at": "2023-03-22T21:33:52.454Z",
    "object": "clip",
    "status": "created"
}

✴️ Example #4: Audio script

Using an audio file instead of a text

POST https://api.d-id.com/clips | Create a clip 

{
    "script": {
        "type": "audio",
        "audio_url": "https://path.to/audio.mp3"
    },
    "presenter_id": "v2_public_Amber@0zSz8kflCN"
}

{
    "id": "clp_auvOUSOANX95VaLCKb2Il",
    "created_at": "2023-03-22T21:33:52.454Z",
    "object": "clip",
    "status": "created"
}

✴️ Example #5: Background

Change the background color. Use HEX color format.

POST https://api.d-id.com/clips | Create a clip 

{
    "script": {
        "type": "audio",
        "audio_url": "https://path.to/audio.mp3"
    },
    "presenter_id": "v2_public_Amber@0zSz8kflCN",
    "background": {
        "color": "#aa22cc"
    }
}

{
    "id": "clp_auvOUSOANX95VaLCKb2Il",
    "created_at": "2023-03-22T21:33:52.454Z",
    "object": "clip",
    "status": "created"
}

Transparent background. Available only in webm format.

POST https://api.d-id.com/clips | Create a clip 

{
    "script": {
        "type": "audio",
        "audio_url": "https://path.to/audio.mp3"
    },
    "presenter_id": "v2_public_Amber@0zSz8kflCN",
    "config": {
        "result_format": "webm"
    },
    "background": {
        "color": false
    }
}

{
    "id": "clp_auvOUSOANX95VaLCKb2Il",
    "created_at": "2023-03-22T21:33:52.454Z",
    "object": "clip",
    "status": "created"
}

✴️ Video Tutorial

D-ID's API - Clips Endpoint
Live Coding Session


✴️ Support


 Have any questions? We're here to help! Just click the Contact Support button below, and we'll be happy to answer shortly.

Contact Support