dubbing
dubbing
dubbing

Dub A Video Or An Audio File

Changed on

Dubs a provided audio or video file into given language.

post/v1/dubbing

Request

  • Base URL
    https://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.elevenlabs.io/v1/dubbing
  • Auth
    none declared

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Request body multipart/form-data

filestring binary nullable

A list of file paths to audio recordings intended for voice cloning

csv_filestring binary nullable

CSV file containing transcription/translation metadata

foreground_audio_filestring binary nullable

For use only with csv input

background_audio_filestring binary nullable

For use only with csv input

namestring nullable

Name of the dubbing project.

source_urlstring nullable

URL of the source video/audio file.

source_langstring

Source language. Expects a valid iso639-1 or iso639-3 language code.

target_langstring nullable

The Target language to dub the content into. Expects a valid iso639-1 or iso639-3 language code.

target_accentstring nullable

[Experimental] An accent to apply when selecting voices from the library and to use to inform translation of the dialect to prefer.

num_speakersinteger

Number of speakers to use for the dubbing. Set to 0 to automatically detect the number of speakers

watermarkboolean

Whether to apply watermark to the output video.

start_timeinteger nullable

Start time of the source video/audio file.

end_timeinteger nullable

End time of the source video/audio file.

highest_resolutionboolean

Whether to use the highest resolution available.

drop_background_audioboolean

An advanced setting. Whether to drop background audio from the final dub. This can improve dub quality where it's known that audio shouldn't have a background track such as for speeches or monologues.

use_profanity_filterboolean nullable

[BETA] Whether transcripts should have profanities censored with the words '[censored]'

dubbing_studioboolean

Whether to prepare dub for edits in dubbing studio or edits as a dubbing resource.

disable_voice_cloningboolean

Instead of using a voice clone in dubbing, use a similar voice from the ElevenLabs Voice Library. Voices used from the library will contribute towards a workspace's custom voices limit, and if there aren't enough available slots the dub will fail. Using this feature requires the caller to have the 'add_voice_from_voice_library' permission on their workspace to access new voices.

mode'automatic' | 'manual'

The mode in which to run this Dubbing job. Defaults to automatic, use manual if specifically providing a CSV transcript to use. Note that manual mode is experimental and production use is strongly discouraged.

csv_fpsnumber nullable

Frames per second to use when parsing a CSV file for dubbing. If not provided, FPS will be inferred from timecodes.

Response

Successful Response

dubbing_idstring required

The ID of the dubbing project.

expected_duration_secnumber required

The expected duration of the dubbing project in seconds.

Example response

{
  "dubbing_id": "21m00Tcm4TlvDq8ikWAM",
  "expected_duration_sec": 127.5
}

Changes

  • 47dc9e66d680Revision changes
    • info

      endpoint deprecated

  • 5b595807512cRevision changes
    • breaking

      request property was restricted to a list of enum values

    • breaking

      request property list-of-types was narrowed by removing types null from media type multipart/form-data

    • info

      api operation id Dub_a_video_or_an_audio_file_v1_dubbing_post removed and replaced with create_dubbing

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new automatic enum value to the request property

    • info

      added the new manual enum value to the request property