DEdeepdub-ai

Submit Dubbing Job

Changed on

Create a new dubbing job. The source video is validated, locales are resolved, and the job is queued for processing. Returns a requestId used to track the job.

post/dubbing/job

Request

  • Base URL
    https://dubbing.deepdub.app
  • Auth
    API key in header x-api-key

Request body

sourceLocalestring required

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

targetLocalestring required

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

sourceVideoPathstring required

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

exportPathstring

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

contentIdstring

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

batchIdstring

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

batchNamestring

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

workflowType'AUTOMATED' | 'MANAGED' | 'MANAGED_HIGH_TIER'

Dubbing workflow tier: AUTOMATED (fully automated), MANAGED (human-in-the-loop QC), or MANAGED_HIGH_TIER (premium managed).

mixType'UN_STYLE' | 'REPLACEMENT'

Audio mixing strategy: REPLACEMENT (replace original dialogue track) or UN_STYLE (overlay dubbed audio on the original).

sourceSpeechTrackPathstring

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

sourceMAndETrackPathstring

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

uncompressedAudioPathstring

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

titleNamestring

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

genreNamestring

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

maturityRatingstring

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

contentTypestring

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

priorityinteger

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

needByDatestring date-time

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

isVideoWaterMarkedboolean

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

metadataobject

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

Response

Successful Response

requestIdstring required

Changes

  • dae0c15f8228Revision changes
    • info

      added the new DFXP_SUBTITLES enum value to the request property ///

    • info

      added the new ITT_SUBTITLES enum value to the request property ///