Dubbing

Submit a dubbing pro job

Changed on

Start an asynchronous job that translates the speech in a video into another language, clones each speaker's voice to say the translation, and lip-syncs their faces to it. Returns the dubbed video.

Inputs

  • video_url — public URL of the video to dub, up to 10 minutes
  • target_language — the language to dub into, as a BCP 47 tag such as es, or one of the dialects below such as es-MX. A region is ignored for a language without dialects: de-DE is dubbed as de
  • source_language — optional; the language spoken in the video. Omit it, or send auto, to detect it
  • voice_cloning_strength — optional; how closely the dubbed voices match the speakers, from 0 to 10. Higher keeps more of each speaker's voice and accent; lower sounds more natural in the target language

Languages

af, ak, am, ar, as, az, be, bg, bo, bs, ca, ceb, cmn, cs, cy, da, de, dgo, el, en, es, et, eu, fa, fi, fil, fr, gl, gu, ha, he, hi, hr, hu, hy, id, is, it, ja, jv, ka, ki, kk, kn, ko, ky, lg, lt, lv, mk, ml, mn, mr, ms, my, ne, nl, no, nso, pa, pl, pt, rn, ro, ru, rw, sd, sk, sl, sq, ss, st, su, sv, sw, ta, te, tg, th, tn, tr, ts, ug, uk, ur, uz, ve, vi, war, wo, yo, yue, zh, zu

Dialects

ar-EG, en-AU, en-CA, en-GB, en-US, es-AR, es-CL, es-ES, es-MX, fr-CA, fr-FR, pt-BR, pt-PT, zh-TW

What happens next

The job is accepted immediately — you get 202 Accepted with a job_id and status PROCESSING. Poll GET /v1/dubbing-pro/{job_id} until the job is COMPLETED or FAILED.

post/v1/dubbing-pro

Request

Headers

X-Veed-Store-IO'0' | '1'

Set to 0 to not store this request's and response's bodies. They are then not available in your request logs for debugging.

X-Veed-Media-Expiration-Secondsinteger

Number of seconds before the media URLs returned for this request expire. A value above the maximum is capped rather than rejected.

Request body

$schemastring uri

A URL to the JSON Schema for this object.

source_languagestring

Language spoken in the video, as a BCP 47 tag. Omit it, or send auto, to detect it.

target_languagestring required

Language to dub into, as a BCP 47 tag.

video_urlstring uri required

URL of the video to dub, up to 10 minutes.

voice_cloning_strengthinteger

How closely the dubbed voices match the speakers. Higher keeps more of each speaker's voice and accent; lower sounds more natural in the target language.

Example request

{
  "$schema": "https://api.veed.io/schemas/DubbingProInput.json",
  "source_language": "en",
  "target_language": "fr",
  "video_url": "https://static-assets.veed.io/api-examples/dubbing-pro-input.mp4"
}

Response

Accepted

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://api.veed.io/schemas/ResourceDubbingJob.json",
  "data": {
    "result": {
      "video": {
        "content_type": "video/mp4"
      }
    }
  }
}

Changes