Real-time Transcription

Real-time transcription turns a live audio or video stream into a Trint transcript while it is still playing. You provide a stream for Trint to read, Trint creates a Trint (transcript) document, and the transcript fills in continuously until you stop it. Authenticate every request with Basic Authentication using your API key ID and secret.

There are two ways to feed Trint a stream:

• Pull — you host the stream and give Trint a streamUrl. Start it with Begin real-time transcription.
• Push — Trint hosts an RTMP endpoint and you push media to it. Get the endpoint and key from Create a push stream, then start sending RTMP to it.

Once a transcript is running you can poll its status and stop it when the broadcast ends.

Begin real-time transcription

Start a new real-time transcript from a stream you host. Pass the streamUrl Trint should read, and optionally a title, language and transcriptDelay (how many seconds Trint waits before emitting transcript text). The response contains the _id of the newly created Trint, which you use to check its status.

curl --request PUT \  --url 'https://api.trint.com/transcripts/realtime/' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "_id": "<newly created trintId>"
}

Create a push stream

Instead of hosting your own stream, generate a Trint-hosted RTMP endpoint and push media to it. The response gives you a streamUrl (for example rtmp://stream.trint.com/live) and a single-use streamKey to authenticate the push, along with the streamId and trintId for the new transcript.

curl --request POST \  --url 'https://api.trint.com/transcripts/realtime/push' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "streamId": "<newly created stream id>",
  "streamUrl": "rtmp://stream.trint.com/live",
  "streamKey": "<single use stream key>",
  "title": "trint title",
  "trintId": "<newly created trint id>"
}

Get real-time status

Poll the current status of a running real-time transcript by its Trint ID. The response reports the processing status, any non-critical warnings (such as failed to generate waveform), any critical errors (such as could not detect media), and the started and expires timestamps in ISO 8601 format.

curl --request GET \  --url 'https://api.trint.com/transcripts/realtime/:trint-id' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET'

{
  "status": "TRANSCRIBING",
  "warnings": [
    "failed to generate waveform"
  ],
  "errors": [
    "could not detect media"
  ],
  "started": "2021-08-20T15:11:33.331Z",
  "expires": "2021-08-20T21:11:33.330Z"
}

Stop real-time transcription

Stop a running real-time transcript and close the session. Supply both the streamId and trintId that identify the active stream and its transcript. A successful request returns an empty object.

curl --request DELETE \  --url 'https://api.trint.com/transcripts/realtime/' \
  --header 'Authorization: Basic YOUR_BASE64_KEY_ID_AND_SECRET' \
  --header 'Content-Type: application/json' \
  --data '{}'

{}