level audio

Bring a timeline to delivery level (a lone recording is placed first with manage_timelines create and clips): every speaking recording to what platforms normalise to, so takes from different days, an upload and a generated voiceover sit together; music and effects move by the amount the speech moved. Clips that follow each other in one recording are one take: one gain, so the level does not step at a cut. A take whose peaks would cross the ceiling takes a limiter: raised by what it needs, the moments that would cross lowered. With no speech the music is levelled and the other sounds move with it. A project’s timeline_id levels every clip of the set. The result says whether the target is reached (within 1.5 LU), each clip’s loudness before and after, and which clips end short and why. Written on the clips, so preview and every export carry it; updateClip limiter: null removes one. mode offset moves the whole cut by one amount. Free, except measuring sound the first time: cloud processing.

POST

tools

level_audio

level audio

curl --request POST \
  --url https://eversince.ai/api/v1/tools/level_audio \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "timeline_id": "<string>"
}
'

import requests

url = "https://eversince.ai/api/v1/tools/level_audio"

payload = { "timeline_id": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({timeline_id: '<string>'})
};

fetch('https://eversince.ai/api/v1/tools/level_audio', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

required

An API key (es_live_…) from Settings, under API keys, or an OAuth access token.

Headers

Idempotency-Key

string

Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.

x-workspace-id

string

The workspace this one call acts in, when it is not the default: for a key or a connected agent, one of the workspaces the user allowed it.

Body

application/json

timeline_id

string

required

The timeline id.

mode

enum<string>

match (default) brings every speaking clip to the target, so takes from different sources agree. offset moves the whole cut by one amount and keeps the mix as it is, for a piece already balanced by hand.

Available options:

match,

offset

platform

enum<string>

Where it plays, which sets the target: youtube, instagram and tiktok -14 LUFS, podcast -16, broadcast -23. Default youtube.

Available options:

youtube,

instagram,

tiktok,

podcast,

broadcast

target_lufs

number

A target of its own, over platform.

Required range: -30 <= x <= -6

clip_ids

string[]

Write only these clips. The level is still worked out over the whole cut, so one clip of an interview is matched to the conversation rather than to itself.

if_revision

The revision get_timeline returned. A stale one fails with revision_conflict instead of applying; so does no revision once a user edited the timeline in the app since this connection last read it.

context

string

Optional: one sentence shown to the user beside this action.

Maximum string length: 600

Response

Done, or a job started for work that runs longer (follow it with get_jobs).

any

required

data

object

required

meta

object

required

Show child attributes

media

object[]

level audio

curl --request POST \
  --url https://eversince.ai/api/v1/tools/level_audio \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "timeline_id": "<string>"
}
'

import requests

url = "https://eversince.ai/api/v1/tools/level_audio"

payload = { "timeline_id": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({timeline_id: '<string>'})
};

fetch('https://eversince.ai/api/v1/tools/level_audio', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Discovery

Timeline

Workspace

Library

Canvas

Generation

Research

Account

Models

Uploads

Webhooks

level audio

Authorizations

Headers

Body

Response