Clips

Get clip transcript

Returns the words spoken in a clip with cuts applied — what viewers actually hear. Times are in ms relative to the clip's playback start. Word indices are stable identifiers for cut-by-transcript; they don't shift when cuts change. Pass startTimeMs/endTimeMs to read a long clip in windows; a word belongs to the window its start time falls in. Pass view=sentences for one row per sentence instead, about a quarter of the size: read the gist of a long clip that way, then the words of the stretch you edit.

get/v1/videos/{id}/clips/{clipId}/transcript

Request

  • Base URL: https://api.tella.com
  • URL: https://api.tella.com/v1/videos/{id}/clips/{clipId}/transcript
  • Auth: HTTP bearer

Path parameters

idstring required

Video identifier

Example:vid_abc123def456
clipIdstring required

Clip identifier

Example:cl_xyz789ghi012

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'

words (default): every word with its index, times and flags. sentences: one row per sentence (first and last word index, start and end time, text), about a quarter of the size, for reading the gist of a long clip. A time window cuts sentences at its edges.

Example:sentences

Response

OK

OR

Example response

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

Changes

No recorded changes to this operation across all 1 revision of this API.