Video Avatar Quickstart

Create photorealistic Full-HD videos using premium presenters. The Clips endpoint provides high-quality avatars with natural body movements.

Create a video

Send a POST request with a presenter ID and the text you want the avatar to speak.

curl -X POST "https://api.d-id.com/clips" \
  -H "Authorization: Basic <YOUR KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "presenter_id": "v2_public_Amber@0zSz8kflCN",
    "script": {
      "type": "text",
      "input": "Hello! This is my first premium avatar video."
    }
  }'

{
  "id": "clp_abc123",
  "created_at": "2024-01-15T10:30:00.000Z",
  "status": "created",
  "object": "clip"
}

Save the id from the response — you'll need it to check the status and retrieve the video.

Available presenters: v2_public_Amber@0zSz8kflCN (female), v2_public_Adam@0GLJgELXjc (male). Call GET /clips/presenters for the full list.

Check the video status

Poll the GET endpoint until the status changes to done. The video typically takes 15-45 seconds to process.

curl -X GET "https://api.d-id.com/clips/clp_abc123" \
  -H "Authorization: Basic <YOUR KEY>"

{
  "id": "clp_abc123",
  "status": "done",
  "result_url": "https://result.d-id.com/.../video.mp4"
}

Poll until status is done. The video typically takes 15-45 seconds to process.

Get your video

Once the status is done, the result_url field contains a direct link to your generated Full-HD video. Download or stream the video from this URL.

curl -O "https://result.d-id.com/.../video.mp4"

The video URL is valid for 24 hours. Store the video or re-fetch the clip to get a fresh URL.