change language

The same speech in another language, in the same voices: every speech clip with words and a voice is translated and re-recorded, a person on camera is dubbed (the translated take under the picture, its own sound off, lips unchanged), text clips, a graphic's text controls and chapter and note markers are translated with the workspace's brand kit words held as written, and captions are re-cut from the new audio. Words inside a picture and a graphic with no text control stay; the job's result counts what was translated and names what was left. Saved as a new timeline named "<name> · <Language>" unless as_new_timeline is false. A speaker with words but no voice (an uploaded recording) gets one built from their recording when consent is true; without it those speakers stay as they are and are named in the plan. One price for the whole dub, on the speech length, refunded if the job fails. Words come first: transcribe_media with timeline_id. A longer take moves later clips and holds its picture, at the level of the old clip. Returns a job; get_jobs carries timeline_id when the new timeline is ready. Subtitles alone are captions translate. Credits.

POST

tools

change_language

change language

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

import requests

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

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

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

target_language

enum<string>

required

The language to speak. The values here are the whole supported set.

Available options:

en,

es,

fr,

de,

it,

pt,

ja,

ko,

zh,

ar,

hi,

ru,

nl,

pl,

sv,

da,

fi,

no,

cs,

sk,

hu,

ro,

bg,

hr,

uk,

el,

tr,

th,

vi,

id,

ms,

fil,

ta,

te,

ml,

kn,

bn,

gu,

mr,

pa,

he,

fa,

ur,

sw,

ha,

af,

ga,

cy,

is,

ca,

gl,

sl,

et,

lv,

lt,

sr,

bs,

mk,

ka,

hy,

az,

kk,

ne

idempotency_key

string

required

Idempotency key (a UUID). A retry with the same key returns the job already dispatched instead of charging again; a new attempt takes a new key.

Required string length: 1 - 200

as_new_timeline

boolean

Default true: a forked copy named " · ". False writes over this timeline.

True records that the user agreed to this statement: "I have the right to clone this voice: it is my own, or the person speaking has agreed to it being recreated and used in this project." Speakers with no voice then get one built from their recording. Omitted, they are left as they are.

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

change language

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

import requests

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

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

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

change language

Authorizations

Headers

Body

Response