Page optimized for desktop experience. Please use a desktop browser for best compatibility.

Translate a Video

Translates a specified video. You must include both the source language and an array of target languages to translate the source language to.

POST
/api/v2/videos/{videoId}/translations

Path Parameters

Name Type Description Required
videoId string videoId to translate Yes

Request Body

application/json

{
"sourceLanguage": "string",
"targetLanguages": [
"string"
]
}

Parameter Type Validations
sourceLanguage string, required

The source language of the initial transcription file to be translated.

targetLanguages [ ] array [ string ], required

The target languages that the video will be translated into.  You must enter the language code. 

Currently supported:

Chinese, Chinese (Mandarin-Simplified), Danish, English, Finnish, French, French-Canadian, German, Greek, Indonesian, Italian, Japanese, Korean, Norwegian, Polish, Portuguese, Russian, Spanish Spain, Swedish, Thai, Turkish

Response Messages

Successful response

Possible status messages include: NotStarted, Preparing, InProgress, Success, Failed

{
  "videoId": "string",
  "title": "string",
  "sourceLanguage": "string",
  "targetLanguages": [
    {
      "language": "string",
      "transcriptionId": "string",
      "status": "NotStarted"
    }
  ]
}

Source language transcript does not exist. No source file exists in that language.

This account has insufficient Rev IQ credits to complete the action.

Invalid language code used.

File already exists for the language code used.

Unauthorized error.

Rev IQ/Translation is not enabled for this account.

Insufficient rights to this video. You do not have edit rights.

Invalid video

Internal server error

Returned if a transcription integration is not activated.