Order Translation

Before you can order a translation, you'll have to have an existing source language transcript available in 3Play Media. You can order this source language transcript with human captions Order Human Captions or ASR Order ASR (auto-captions). Once you've ordered a transcript, you can order Translation with the Order Translation Service endpoint.

This will put an order on our system and begin your translation job.

Determine language IDs

Before ordering translation, you'll need to determine the language IDs you'll be using by hitting the List all Languages endpoint.

Get Translation Service Options (Language Pairs)

Next, get the different options 3Play offers for a given language pair by hitting the List Translation Service Options endpoint and supplying source_language_id and target_language_id. For example, to get all options for translating from English to Italian, you'd query: /v3/translation_service_options?source_language_id=1&target_language_id=8&api_key=<api_key>.

Order Translation

Now, order translation by hitting the Order Translation Service endpoint, supplying the media_file_id and translation_service_option_id from above.

The object that is returned is a standard 3Play Transcript object (same that is returned from Order Human Captions endpoint.

Getting Translated Transcript Status

For testing purposes, you can check a transcript's status by hitting the Get Transcript by ID endpoint and checking the status field.

For Production applications, polling endpoints for status is an anti-pattern, so you'll want to specify a callback URL in the Order Translation Service endpoint. Whenever the order's status changes, we'll ping your API back.

Downloading your Translated Transcript

Once your transcript is complete (status = complete), you can download your transcript via the Download Transcript endpoint. There are many formats you can choose from. Check the Get Available Output Formats endpoint to see what's available.