API Reference
Start typing to search…

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! Go to the Help Center or send us a message.

Contact Support