speakers

Who speaks in a recording and when: voices told apart and matched against those this workspace has named, kept on the file. name stores a voice print of that person that recognises them across the workspace’s recordings; the user’s Terms require their permission where the law does. unname takes a name off this recording; merge joins two speakers the read split. too_short marks too little speech to match, and sounds_like a probable match to confirm by naming. Times are seconds into the file. transcript: true labels the stored sentences with their speaker. For the words, transcribe_media. First read: cloud processing.

POST

/

tools

/

speakers

speakers

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

import requests

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

payload = { "ref": "<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({ref: '<string>'})
};

fetch('https://eversince.ai/api/v1/tools/speakers', 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

ref

string

required

An item ref, item id, or the job id that made it.

name

object

Show child attributes

unname

integer

Take the name off this speaker in this recording. The workspace still knows the voice.

Required range: x >= 0

merge

object

Show child attributes

transcript

boolean

Also return the recording's stored sentences, each labelled with who was speaking.

reread

boolean

Listen again from scratch rather than returning what was read before.

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[]

speakers

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

import requests

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

payload = { "ref": "<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({ref: '<string>'})
};

fetch('https://eversince.ai/api/v1/tools/speakers', 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>"
    }
  }
}