API Reference

Create an agentic video

post
https://api.d-id.com/agentic-videos

Create a new agentic video from a source video. Returns immediately with the
video_id; processing and agent creation happen asynchronously, so poll
GET /agentic-videos/{video_id} and watch status until it reaches done.

Body Params

Payload to create a new agentic video.

string
required

URL of the source video to turn into an agentic video. Accepts either:

  • a direct file URL (.mp4, .mov, .mpeg) reachable over https://, or
  • a YouTube video URL (watch, shorts, youtu.be, embed, or live links).

Uploaded/direct-file videos may be up to 20 minutes long.

string
length ≤ 200

Display name for the agentic video. If omitted, a name is derived from the source
(the YouTube title or the file name).

string
required
length ≥ 1

ID of the presenter that fronts the agent in the chat experience. Must be an
expressive avatar.

background
object

Background shown behind the presenter.

greetings
object

Greetings the agent speaks at key moments of the experience.

string
length ≤ 300

Text shown in the call-to-action bubble that invites viewers to start chatting.

string
length ≤ 40000

Optional knowledge base text the agent uses to answer viewer questions. Applies to
YouTube sources; for uploaded videos the knowledge is derived automatically from the
video's transcript.

boolean
Defaults to true

Whether the agent automatically appears when the video finishes playing.

Responses

Updated about 2 hours ago

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 hours ago