URL Expired

The URL for this request expired after 30 days.

root_video_id

uuid

required

The ID of the studio video to translate.

targetLanguages

array of strings

required

length ≥ 1

List of language codes to translate the video into. See https://docs.synthesia.io/docs/supported-languages for accepted values.

Targetlanguages* string

ADD string

translateScriptOnly

boolean

Defaults to false

If true, only the script is translated.

truefalse

`` 202 Accepted – translation workflows started (or already running).

object

id

uuid

required

The ID of the studio video to translate.

translations

array of objects

required

List of translations that were created or updated.

Translations*

object

language

string

required

status

string

enum

Defaults to in_progress

in_progress

step

string

enum

required

translation

startedByRequest

boolean

Defaults to true

Whether the translation was started by the request.

`` 400 Bad Request – validation failed (unsupported language, wrong video type, translations not available for this workspace plan, or incompatible options).

`` 403 Forbidden – wrong API key or user lacks edit permission for the video.

`` 404 Not Found – video not found or Translations API disabled.

`` default Unexpected server error.

Updated about 2 months ago

ShellNodeRubyPHPPython

xxxxxxxxxx

curl --request PUT \

--url https://api.synthesia.io/v2/translations/root_video_id \

--header 'accept: application/json' \

--header 'content-type: application/json' \

--data '

{

"targetLanguages": [],

"translateScriptOnly": false

}

'

xxxxxxxxxx

{

"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",

"translations": [\
\
    {\
\
      "language": "fr",\
\
      "status": "in_progress",\
\
      "step": "translation"\
\
    }\
\
  ]

}