introduction

at sync., we make it easy to bring your video content to global audiences. our /translate endpoint doesn’t just translate; it transforms your videos to match lip movements with the new audio. ideal for anyone looking to broaden their reach without losing the video’s original charm.

explore how our api can make your videos more accessible and engaging across different languages. get started with our straightforward integration process today.

api features

authentic synchronization

our advanced ai ensures translated audio matches your video’s lip movements perfectly.

wide language support

broaden your reach with support for multiple languages.

easy integration

integrate our technology seamlessly into your workflow with our developer-friendly tools.

available models

explore our diverse range of models, each designed for specific syncing needs. selecting the appropriate model ensures optimal performance and results.

model id:

sync-1.6.0

description: our best mode, everything good about sync-1.5 but now with fluid, human-like mouth movements. When to switch to 1.5: (i) you want the mouth movements to be more visibly prominent, (ii) you observe visual artifacts at the scene boundaries.

when to use: opt for this model to address nuances in teeth visibility and mouth coloration for a flawless finish.

model id:

sync-1.5.0

description: accurate, high-resolution translate that has been proven to be reliable over a large variety of videos. Why choose this: if sync-1.6 model gives you feeble-looking lip movements, this version can perform better.

why choose: perfect when upgrading from earlier versions or seeking a stable, tested option when the latest beta model doesn’t fit your project needs.

model id:

wav2lip++

description: low-resolution, fast, translate that will be free forever. Not suitable for commercial use.

why choose: use this for fast processing of low-resolution videos or for testing purposes.

model ids:

sync-1

sync-1.5.1-beta

description: offering compatibility for projects initiated on older standards, this model ensures continuity. automatically upgrades to sync-1.5.0 for enhanced outcomes.

legacy advantage: use this for ongoing projects needing legacy support with the benefit of automatic quality improvements.

supported languages

explore the full array of languages our api supports, ensuring your content is globally understood. the list below presents all the language options available:

find the perfect language for your audio synchronization project from our extensive selection. each language code is paired with its corresponding language for your convenience.

language codes and names:

aa - Afar          ab - Abkhazian      ae - Avestan
af - Afrikaans     ak - Akan           am - Amharic
an - Aragonese     ar - Arabic         as - Assamese
av - Avaric        ay - Aymara         az - Azerbaijani
ba - Bashkir       be - Belarusian     bg - Bulgarian
bh - Bihari        bi - Bislama        bm - Bambara
bn - Bengali       bo - Tibetan        br - Breton
bs - Bosnian       ca - Catalan        ce - Chechen
ch - Chamorro      co - Corsican       cr - Cree
cs - Czech         cu - Church Slavic  cv - Chuvash
cy - Welsh         da - Danish         de - German
dv - Divehi        dz - Dzongkha       ee - Ewe
el - Greek         en - English        eo - Esperanto
es - Spanish       et - Estonian       eu - Basque
fa - Persian       ff - Fulah          fi - Finnish
fj - Fijian        fo - Faroese        fr - French
fy - Frisian       ga - Irish          gd - Gaelic
gl - Galician      gn - Guarani        gu - Gujarati
gv - Manx          ha - Hausa          he - Hebrew
hi - Hindi         ho - Hiri Motu      hr - Croatian
ht - Haitian       hu - Hungarian      hy - Armenian
hz - Herero        ia - Interlingua    id - Indonesian
ie - Interlingue   ig - Igbo           ii - Sichuan Yi
ik - Inupiaq       io - Ido            is - Icelandic
it - Italian       iu - Inuktitut      ja - Japanese
jv - Javanese      ka - Georgian       kg - Kongo
ki - Kikuyu        kj - Kuanyama       kk - Kazakh
kl - Kalaallisut   km - Khmer          kn - Kannada
ko - Korean        kr - Kanuri         ks - Kashmiri
ku - Kurdish       kv - Komi           kw - Cornish
ky - Kirghiz       la - Latin          lb - Luxembourgish
lg - Ganda         li - Limburgan      ln - Lingala
lo - Lao           lt - Lithuanian     lu - Luba-Katanga
lv - Latvian       mg - Malagasy       mh - Marshallese
mi - Maori         mk - Macedonian     ml - Malayalam
mn - Mongolian     mr - Marathi        ms - Malay
mt - Maltese       my - Burmese        na - Nauru
nb - Norwegian Bokmål nd - North Ndebele ne - Nepali
ng - Ndonga        nl - Dutch          nn - Nynorsk
no - Norwegian     nr - South Ndebele  nv - Navajo
ny - Chichewa      oc - Occitan        oj - Ojibwa
om - Oromo         or - Oriya          os - Ossetian
pa - Panjabi       pi - Pali           pl - Polish
ps - Pushto        pt - Portuguese     qu - Quechua
rm - Romansh       rn - Rundi          ro - Romanian
ru - Russian       rw - Kinyarwanda    sa - Sanskrit
sc - Sardinian     sd - Sindhi         se - Northern Sami
sg - Sango         si - Sinhala        sk - Slovak
sl - Slovenian     sm - Samoan         sn - Shona
so - Somali        sq - Albanian       sr - Serbian
ss - Swati         st - Southern Sotho su - Sundanese
sv - Swedish       sw - Swahili        ta - Tamil
te - Telugu        tg - Tajik          th - Thai
ti - Tigrinya      tk - Turkmen        tl - Tagalog
tn - Tswana        to - Tonga          tr - Turkish
ts - Tsonga        tt - Tatar          tw - Twi
ty - Tahitian      ug - Uighur         uk - Ukrainian
ur - Urdu          uz - Uzbek          ve - Venda
vi - Vietnamese    vo - Volapük        wa - Walloon
wo - Wolof         xh - Xhosa          yi - Yiddish
yo - Yoruba        za - Zhuang         zh - Chinese
zu - Zulu

quick start

authentication

before you can start using our api, you need to authenticate your requests. this is done using an x-api-key that links your requests to your account. if you don’t have an api key yet, check out the instructions here to obtain one.

translate your videos

with your x-api-key ready to go, you can now start translating your videos. to translate video via the playground above follow the instructions below:

authorize

enter your api key in the x-api-key field within the Authorization section.

enter your x-api-key in the authorization section

enter params

enter the params in the body section:

enter the video url, target language and any other optional parameters into the respective fields.

example input

{
  "videoUrl": "https://example.com/video.mp4",
  "targetLanguage": "en",
  "model": "sync-1.6.0"
}

submit

click the Send button to submit your translation request. after submission, you will receive a response that includes the id of your translation job, the current status, and details of the original submission.

understanding the response

the initial response provides you with essential details to track your job:

{
  "id": "unique_job_id",
  "createdAt": "date_time",
  "videoUrl": "",
  "status": "processing",
  "original_audio_url": "https://example.com/audio.mp3",
  "original_video_url": "https://example.com/video.mp4",
  "synergize": true,
  "creditsDeducted": 123,
  "webhookUrl": null,
  "errorMessage": null
}

your job’s status will start as pending and move to processing. use the returned id with the GET /translate/{id} endpoint to periodically poll for the status of your job. this polling is crucial for knowing when your video is ready.

polling for completion

periodically send requests to GET /translate/{id} with your job id. when the job status changes to completed, the response will include a URL to download your synced video.

Click here to view instructions on polling for job completion with the get translate api playground

Authorizations

x-api-key

string

headerrequired

Body

application/json

videoUrl

string

required

A url to the video file to be translated and synchronized -- must be publicly accessible

targetLanguage

string

default: enrequired

Target language to translate the video to

maxCredits

number

Maximum number of credits to use for video generation. If job exceeds this value, the job will be aborted

webhookUrl

string

A url to send a notification to upon completion of video generation

model

string

default: sync-1.6.0

The model to use for video generation.

Response

201 - application/json

string

required

A unique identifier for the translation job.

createdAt

string

required

The date and time the translation job was created.

status

string

required

The status of the translation job.

step

object

required

The step of the translation job.

videoUrl

object

A URL which can be used to download the video.

audioUrl

object

required

A URL which can be used to download the audio.

transcriptUrl

object

A URL to access the transcript of the video.

originalVideoUrl

string

required

The original URL of the video that was submitted.

sourceLanguage

object

required

The source language of the video.

targetLanguage

string

The language into which the video is being translated.

creditsDeducted

object

required

The number of credits deducted for the translation.

webhookUrl

object

required

The webhook URL for the translation job.

errorMessage

object

required

An error message if the translation job failed to process.

api documentation

lipsync

animate

speak

voices

Post translate

introduction

api features

authentic synchronization

wide language support

easy integration

available models

supported languages

quick start

authentication

translate your videos

example input

understanding the response

polling for completion

Authorizations

Body

Response

api documentation

lipsync

animate

speak

voices

​introduction

​api features

authentic synchronization

wide language support

easy integration

​available models

​supported languages

​quick start

​authentication

​translate your videos

example input

understanding the response

polling for completion

Authorizations

Body

Response

introduction

api features

available models

supported languages

quick start

authentication

translate your videos