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.
Before ordering translation, you'll need to determine the language IDs you'll be using by hitting the List all Languages endpoint.
Next, get the different options 3Play offers for a given language pair by hitting the List Translation Service Options endpoint and supplying
target_language_id. For example, to get all options for translating from English to Italian, you'd query:
Now, order translation by hitting the Order Translation Service endpoint, supplying the
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.
For testing purposes, you can check a transcript's status by hitting the Get Transcript by ID endpoint and checking the
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.
Once your transcript is complete (
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.
Updated 4 months ago