Video Jobs

Video jobs allow you to localize videos into other languages using AI. You can create a full dubbing job, generate translated and time-aligned subtitles, or produce a voice-over mixed over the original audio track. Provide the source video as a direct URL or YouTube link, or upload a file via the files endpoints and pass its S3 key. Each endpoint responds with a job object; use the translation jobs endpoints to track job status and retrieve results.

Create a video dub job

POST /v1/jobs/video/dub This endpoint allows you to create a full dubbing job, where the original voice is replaced via smart vocal removal. Provide the source video via either source_video_url or source_file.

Required attributes

string

required

Source language code (e.g., “en”).

string

required

Target language code with locale (e.g., “fr-FR”).

Optional attributes

string

Direct URL or YouTube link to the source video.

string

S3 key (without org prefix) of a video previously uploaded via /files/upload. Mutually exclusive with source_video_url.

string

Display name for the Dubformer project.

array

List of glossary IDs to use for terminology.

object

Dubformer-specific TTS / dubbing tuning. Object with tts_volume — the loudness of the synthesized voice track (defaults to Dubformer’s “normal” when unset).

curl -X POST https://api.elanlanguages.ai/v1/jobs/video/dub \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}" \
  -H "Content-Type: application/json" \
  -d '{
    "source_video_url": "https://www.youtube.com/watch?v=abc123xyz",
    "source_lang": "en",
    "target_lang": "fr-FR",
    "project_name": "Product launch video",
    "glossaries": [1]
  }'

Response

{
  "job_id": "job_dub_abc123def456",
  "status": "queued",
  "message": "Video dub job created successfully",
  "created_at": "2025-12-21T10:34:41.135Z"
}

Create a video subtitle job

POST /v1/jobs/video/subtitle This endpoint allows you to create a subtitling job that produces translated, time-aligned subtitles for a video. Provide the source video via either source_video_url or source_file.

Required attributes

string

required

Source language code (e.g., “en”).

string

required

Target language code with locale (e.g., “fr-FR”).

Optional attributes

string

Direct URL or YouTube link to the source video.

string

S3 key (without org prefix) of a video previously uploaded via /files/upload. Mutually exclusive with source_video_url.

string

Display name for the Dubformer project.

array

List of glossary IDs to use for terminology.

object

Dubformer-specific TTS / dubbing tuning. Object with tts_volume — the loudness of the synthesized voice track (defaults to Dubformer’s “normal” when unset).

curl -X POST https://api.elanlanguages.ai/v1/jobs/video/subtitle \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}" \
  -H "Content-Type: application/json" \
  -d '{
    "source_file": "videos/product-launch.mp4",
    "source_lang": "en",
    "target_lang": "de-DE",
    "project_name": "Product launch subtitles"
  }'

Response

{
  "job_id": "job_sub_abc123def456",
  "status": "queued",
  "message": "Video subtitle job created successfully",
  "created_at": "2025-12-21T10:34:41.135Z"
}

Create a video voiceover job

POST /v1/jobs/video/voiceover This endpoint allows you to create a voice-over job, where the translated voice is mixed over the original track. Provide the source video via either source_video_url or source_file.

Required attributes

string

required

Source language code (e.g., “en”).

string

required

Target language code with locale (e.g., “fr-FR”).

Optional attributes

string

Direct URL or YouTube link to the source video.

string

S3 key (without org prefix) of a video previously uploaded via /files/upload. Mutually exclusive with source_video_url.

string

Display name for the Dubformer project.

array

List of glossary IDs to use for terminology.

object

Dubformer-specific TTS / dubbing tuning. Object with tts_volume — the loudness of the synthesized voice track (defaults to Dubformer’s “normal” when unset).

curl -X POST https://api.elanlanguages.ai/v1/jobs/video/voiceover \
  -H "Authorization: Bearer {token}" \
  -H "X-Org-Id: {orgId}" \
  -H "Content-Type: application/json" \
  -d '{
    "source_video_url": "https://www.youtube.com/watch?v=abc123xyz",
    "source_lang": "en",
    "target_lang": "fr-FR",
    "video": {
      "tts_volume": "normal"
    }
  }'

Response

{
  "job_id": "job_vo_abc123def456",
  "status": "queued",
  "message": "Video voiceover job created successfully",
  "created_at": "2025-12-21T10:34:41.135Z"
}

Guides

Jobs & Translation

Resources

Webhooks

Account

Create a video dub job

Required attributes

Optional attributes

Create a video subtitle job

Required attributes

Optional attributes

Create a video voiceover job

Required attributes

Optional attributes

​Create a video dub job

​Required attributes

​Optional attributes

​Create a video subtitle job

​Required attributes

​Optional attributes

​Create a video voiceover job

​Required attributes

​Optional attributes

Create a video dub job

Required attributes

Optional attributes

Create a video subtitle job

Required attributes

Optional attributes

Create a video voiceover job

Required attributes

Optional attributes