---
title: "Get audio levels in a clip"
method: GET
path: "/v1/videos/{id}/clips/{clipId}/audio-levels"
tags: ["Clips"]
---

# Get audio levels in a clip

`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
- TypeScript: <https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/videos/:id/clips/:clipId/audio-levels/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `id` string, required: Video identifier
- `clipId` string, required: Clip identifier

## Query parameters

- `startTimeMs` number, required: Start of the range on the clip's playback timeline, in ms
- `endTimeMs` number, required: End of the range on the clip's playback timeline, in ms
- `stepMs` number: Width of each level step in ms (default 10, at least 5). A range may have up to 12,000 steps.

## Response `200`

OK

- ClipAudioLevelsResponse: Peak loudness of a clip's voice track per step
  - `levelsDb` number[], required: Peak level in dBFS per step from startTimeMs (0 is full scale); null where there is no audio
  - `resolutionMs` number, required: Length of one stored waveform bucket; a step within this distance of a cut may include a little cut audio
  - `startTimeMs` number, required
  - `stepMs` number, required

## Other responses

- `400`: The request was malformed or contained invalid parameters.
- `401`: Authentication is required. Provide a valid API key.
- `403`: You don't have permission to access this resource.
- `404`: The requested resource was not found.
- `409`: The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles.
- `429`: You have exceeded the rate limit. Please slow down.
- `500`: An unexpected error occurred
- `501`: The requested operation is not implemented.
- `503`: A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay.

## Changes

> 72 revisions in range; 1 not diffed.

- **2026-10-09** `25910750ad41`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withchima/apis/tella-public-api/changes/v1/videos/:id/clips/:clipId/audio-levels/get.md)

---

[API](https://skmtc.dev/withchima/apis/tella-public-api.md) - [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withchima/apis/tella-public-api/revisions/ca74daaf9201?raw)