Sign in

v1

latestOpenAPI 3.0.32026-07-24106305257.4 KB
Talks (Standard Avatars)

Create a talk

post/talks

Headers

x-api-key-externalstring

Use your own ElevenLabs API key for TTS (IVC voices only), consuming your ElevenLabs quota. Example: {"elevenlabs": "ABCDEFGH123456"}

Request body

source_urlstring

The URL of the source image to be animated by the driver video, or a selection from the list of provided studio actors.

user_datastring
namestring

The name of the talk video

webhookstring
result_urlstring

Example request

{
  "source_url": "https://path.to.directory/image.jpg",
  "script": {
    "provider": {
      "voice_id": "en-US-JennyNeural",
      "voice_config": {
        "rate": "0.5",
        "pitch": "+2st"
      },
      "language": "English (United States)"
    },
    "input": "Making videos is easy with D-ID",
    "dictionary_id": "dict_V1StGXR8_Z5jdHi6B-myT"
  },
  "config": {
    "logo": {
      "position": [
        0,
        500
      ]
    }
  },
  "result_url": "https://path.to.directory/movie.mp4"
}

Response

Created

idstring required

The ID of the talk

objectstring required

An identifier of this talk

created_bystring required

The user id of the user that created the talk

created_atstring required

Talk creation time as iso-8601 string

status'created' | 'done' | 'error' | 'started' | 'rejected' required