Clips

Get audio levels in a clip

Returns how loud a clip's voice track is over a stretch of its playback timeline (cuts applied, the same times as the transcript and silences endpoints): the peak level in dBFS for each step (0 is full scale; speech is usually above about -30, room tone well below -40; null where there is no audio). Levels come from stored waveform buckets about 5 ms long (resolutionMs), so a step right next to a cut can include a little of the cut audio. Use it to check what is left at a cut or to find a breath, click or filler the transcript misses.

get/v1/videos/{id}/clips/{clipId}/audio-levels

Request

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

Path parameters

idstring required

Video identifier

Example:vid_abc123def456
clipIdstring required

Clip identifier

Example:cl_xyz789ghi012

Query parameters

startTimeMsnumber required

Start of the range on the clip's playback timeline, in ms

Example:12000
endTimeMsnumber required

End of the range on the clip's playback timeline, in ms

Example:15000
stepMsnumber

Width of each level step in ms (default 10, at least 5). A range may have up to 12,000 steps.

Example:10

Response

OK

levelsDbnumber[] required

Peak level in dBFS per step from startTimeMs (0 is full scale); null where there is no audio

resolutionMsnumber required

Length of one stored waveform bucket; a step within this distance of a cut may include a little cut audio

startTimeMsnumber required
stepMsnumber required

Changes

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