sync recordings

Line up recordings made at the same time: several cameras on one take, a camera and a separate microphone, a screen recording and a webcam. Timecode is used where a camera wrote one; otherwise the sound is matched at several points and checked for agreement before an offset is believed, drift included. Every file is placed on its own track at the right moment and the group is remembered, which is what lets switch_angle change the shot. A file that does not match comes back named and unplaced. A long take answers that it is still listening; a later call returns the offsets. Free with timecode; listening is cloud processing.

POST

/

tools

/

sync_recordings

sync recordings

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

import requests

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

payload = {
    "timeline_id": "<string>",
    "refs": ["<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>', refs: ['<string>']})
};

fetch('https://eversince.ai/api/v1/tools/sync_recordings', 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,
      "queued_minutes": 123,
      "left_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,
      "queued_minutes": 123,
      "left_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 key's own.

Body

application/json

timeline_id

string

required

The timeline id.

refs

string[]

required

The library items recorded together: video or audio, two to twelve.

Required array length: 2 - 12 elements

name

string

What to call the group. Default: the timeline's name.

Maximum string length: 60

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).

ok

any

required

data

object

required

meta

object

required

Show child attributes

media

object[]

sync recordings

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

import requests

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

payload = {
    "timeline_id": "<string>",
    "refs": ["<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>', refs: ['<string>']})
};

fetch('https://eversince.ai/api/v1/tools/sync_recordings', 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,
      "queued_minutes": 123,
      "left_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,
      "queued_minutes": 123,
      "left_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}