Skip to main content
GET
Get the beats of the background music

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Unique video identifier

Example:

"vid_abc123def456"

Response

OK

Tempo, beats and bars of a music track, analyzed once per track and cached

beatsMs
number[]
required

Every beat, in ms: on the video's playback timeline for background music (the same times as get_timeline), in source time for a source

Required range: x >= 0
Example:
beatsPerBar
integer
required

Beats in each bar: 4, or 3 for a waltz-like meter

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

4

bpm
number
required

Tempo in beats per minute. 0 when the track has no beat at all

Required range: x >= 0
Example:

120

confidence
number
required

How clearly the track has a pulse, 0 to 1. Steady produced music is usually above 0.4; beatless ambient music below 0.1, where the beats are only a guess

Required range: 0 <= x <= 1
Example:

0.86

downbeatsMs
number[]
required

The first beat of every bar, a subset of beatsMs. Cut or start a motion on these for the strongest musical accents

Required range: x >= 0
Example:
durationMs
number
required

Length of the timeline the beats are on: the video's playback duration for background music, the source's duration for a source

Required range: x >= 0
Example:

95200

trackDurationMs
number
required

Length of one pass of the track. Background music restarts after it, so its beat grid restarts too

Required range: x >= 0
Example:

180036