Log In to SpeakerText

Initiate Transcription

This method is used to initiate one or more SpeakerText transcriptions.

URLhttps://api.speakertext.com/v1/transcripts
MethodPOST
Required Parameterssources: (JSON) single source object or array of source objects
Optional Parameterspingback_url: If present, we will make a POST request to this URL upon transcript completion. The body of the request will have three keys: transcript_id (SpeakerText's transcript id), ref_id (the media reference id or video id you specified in the original POST), and content (the HTML transcript for CaptionBox).
Responses 201 Created
Transcription requests were processed successfully. A JSON object is returned containing the following keys:
  • transcript_ids: An array of unique IDs which can be used to access the transcription results.
  • credits_used: Cost of the order, in credits.
  • balance: Remaining number of credits in your account
400 Bad Request
There is a problem with the input data. See the "message" parameter for more information.
401 Unauthorized
Your credentials are incorrect. Check your API key.
402 Payment Required
There are not enough credits in your account to cover the purchase. The parameter "credits_required" will let you know how many credits are necessary to purchase the entire order.
500 Internal Server Error
An unknown error occurred.