Order Human Captions

To order high-accuracy human captions, do the following:

• Create a media file: Create Media File
• Determine your turnaround level: List Turnaround Levels
  • Use id=1 for standard turnaround
• Order a transcript: Order Transcript Service providing the media_file_id and turnaround_level_id from the above calls.

This will put an order on our system and get it sent to a human captioner.

Getting 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 Transcript Service. Whenever the order's status changes, we'll ping your API back.

For more information on using callbacks, check out Using Callback URLs

Downloading your 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.