Skip to main content
POST
Translate a transcript into many languages with cue-accurate captions, and optionally dubbed audio.

Authorizations

Authorization
string
header
required

A workspace API key (sk_live_...), minted from workspace settings.

Body

application/json
targetLanguages
string[]
required
Required array length: 1 - 20 elements
Required string length: 1 - 20
projectId
string
required

The project to file this work under. Required — create one with POST /v1/projects. A project this workspace does not own answers not_found; the work is never silently filed somewhere else.

Maximum string length: 200
transcript
object

The transcript to translate. Send exactly one of transcript or assetId.

assetId
string

Translate a transcript this workspace has already had transcribed instead of sending one. Send exactly one of transcript or assetId. An asset in another workspace is reported as not found.

Required string length: 1 - 200
sourceLanguage
string

Source language. Required with assetId when no language was recorded for that asset — there is no default, because guessing would mis-translate a non-English asset silently.

Required string length: 1 - 20
dub
boolean
default:false
captionFormat
enum<string>
Available options:
srt,
vtt
voiceId
string
Maximum string length: 120
provider
string
Maximum string length: 60
context
string
Maximum string length: 4000

Response

Completed.

success
enum<boolean>
required
Available options:
true
projectId
string
required

The project this work was filed under.