Skip to main content
POST
/
dubbing
/
job
Submit Dubbing Job
curl --request POST \
  --url https://dubbing.deepdub.app/dubbing/job \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "sourceLocale": "<string>",
  "targetLocale": "<string>",
  "sourceVideoPath": "<string>"
}
'
{
  "requestId": "<string>"
}

Authorizations

​
x-api-key
string
header
required

API key issued by Deepdub. Contact your account manager to obtain one.

Body

application/json
​
sourceLocale
string
required

Locale code of the source language (e.g., 'en-US')

​
targetLocale
string
required

Locale code of the target language (e.g., 'es-ES')

​
sourceVideoPath
string
required

S3 or HTTPS path to the source video file (e.g., 's3://bucket/video.mp4' or 'https://example.com/video.mp4')

​
exportPath
string

S3 path where the dubbed video will be exported (must start with 's3://', e.g., 's3://bucket/output.mp4')

​
contentId
string

Unique identifier for the content (e.g., 'content_123')

​
batchId
string

Identifier for the batch this submission belongs to (e.g., 'batch_001')

​
batchName
string

Name of the batch this submission belongs to (e.g., 'Power Rangers Season 1')

​
workflowType
enum<string>
default:AUTOMATED

Type of workflow to use for dubbing (e.g., 'AUTOMATED', 'MANAGED')

Available options:
AUTOMATED,
MANAGED,
MANAGED_HIGH_TIER
​
mixType
enum<string>
default:REPLACEMENT

Type of audio mix to use for dubbing (e.g., 'REPLACEMENT', 'UN_STYLE')

Available options:
UN_STYLE,
REPLACEMENT
​
sourceSpeechTrackPath
string

S3 path to the source speech audio track, if separate from video (must start with 's3://', e.g., 's3://bucket/audio.wav')

​
sourceMAndETrackPath
string

S3 path to the source Music & Effects (M&E) track (must start with 's3://', e.g., 's3://bucket/me_track.wav')

​
uncompressedAudioPath
string

S3 path to the uncompressed audio file, if available (must start with 's3://', e.g., 's3://bucket/uncompressed.wav')

​
segments
DubbingSegment · object[]

List of segments to be dubbed, with timing and dialogue information

​
titleName
string

Title of the content (e.g., 'The Great Adventure')

​
genreName
string

Genre of the content (e.g., 'Action', 'Comedy')

​
maturityRating
string

Maturity rating of the content (e.g., 'PG-13', 'R')

​
contentType
string

Type of content (e.g., 'movie', 'series')

​
priority
integer

Priority of the dubbing job (higher means more urgent, e.g., 10)

​
needByDate
string<date-time>

Date by which the dubbed content is needed (e.g., '2024-07-01T12:00:00Z')

​
isVideoWaterMarked
boolean
default:false

Indicates if the source video is watermarked (e.g., True, False)

​
additionalSources
DubbingSubmissionAdditionalSource · object[]

Additional source assets to attach as input reference material (e.g., closed captions, audio hints)

​
additionalProducts
DubbingSubmissionAdditionalProduct · object[]

Deliverable products to produce alongside or instead of the dubbed video (e.g., SRT subtitles, transcripts)

​
metadata
Metadata · object

Metadata attached to the dubbing job (e.g., {'key': 'value'})

Response

Successful Response

​
requestId
string
required