WIwithchima
Sources

Get the transcript of a source on no clip

Changed on

Returns the words spoken in a streaming upload source owned by the caller or their workspace, without a video or clip: for a source that isn't on any clip yet, such as an imported video. Times are in ms of source time and no cuts apply. Answers 503 while the source is still being transcribed. Takes the same startTimeMs/endTimeMs window and view=sentences or view=text as the clip transcript.

get/v1/sources/{sourceId}/transcript

Request

Path parameters

sourceIdstring required

Streaming upload source identifier

Example:su_abc123def456

Query parameters

startTimeMsinteger

Only return items at or after this time, in ms on the clip's playback timeline. Defaults to the clip's start.

Example:60000
endTimeMsinteger

Only return items before this time (exclusive), in ms on the clip's playback timeline. Must be greater than startTimeMs. Defaults to the clip's end. Page through a long clip with windows that meet end to start.

Example:120000
view'words' | 'sentences' | 'text'

words (default): every word with its index, times and flags. text: every word with its index as plain text, one sentence per line starting with its start time, about a seventh of the size, for reading a whole long clip (finding retakes, repeats or where something is said). sentences: one row per sentence (first and last word index, start and end time, text), about a quarter of the size. A time window cuts sentences at its edges.

Example:text
includeCut'true' | 'false'

true: also return the words that cuts removed, each marked cut, with every word's times in the clip's source recording (sourceStartTimeMs/sourceEndTimeMs). Use it to find footage the cuts took out, such as a retake, without undoing the cuts. Kept words still carry their playback startTimeMs/endTimeMs. startTimeMs/endTimeMs filter on the source times. Words view only.

Example:true

Response

OK

OR
OR

Example response

{
  "words": [
    {
      "endTimeMs": 1800,
      "index": 12,
      "startTimeMs": 1500,
      "text": "Hello"
    }
  ]
}

Changes