API REFERENCE · PLATFORM

Languages

99 source languages in, 30 out; codes are lowercase BCP 47 (ISO 639-1 where one exists), the same everywhere.

01.The 30 output languages

Three quality tiers, best first, alphabetical inside each; every one is production and any-to-any among the 30. Tier 1 is where voice and lip-sync quality is highest today; Tier 3 is good and gets the next tuning passes.

TABLE 01 · OUTPUT LANGUAGES BY QUALITY TIER
CODELANGUAGETIER
yueCantoneseTier 1
enEnglishTier 1
frFrenchTier 1
deGermanTier 1
idIndonesianTier 1
itItalianTier 1
jaJapaneseTier 1
koKoreanTier 1
zhMandarinTier 1
ptPortugueseTier 1
ruRussianTier 1
esSpanishTier 1
thThaiTier 1
viVietnameseTier 1
bgBulgarianTier 2
caCatalanTier 2
hrCroatianTier 2
nlDutchTier 2
elGreekTier 2
ltLithuanianTier 2
noNorwegianTier 2
skSlovakTier 2
svSwedishTier 2
arArabicTier 3
beBelarusianTier 3
daDanishTier 3
kkKazakhTier 3
lvLatvianTier 3
srSerbianTier 3
ukUkrainianTier 3

All 30 work as source and target on uploads. Live sessions (experimental) take 32 source languages and output the same 30.

02.The 99 source languages

The 30 output languages are all in the list; the other 69 are source only: the speech is transcribed and translated, and the dub comes out in any of the 30 output languages. Pass the code as source_lang, or leave auto.

TABLE 02 · SOURCE LANGUAGES (ALPHABETICAL)
CODEISO 639-3LANGUAGEOUTPUT
afafrAfrikaanssource only
amamhAmharicsource only
araraArabicyes
hyhyeArmeniansource only
asasmAssamesesource only
astastAsturiansource only
azazeAzerbaijanisource only
bebelBelarusianyes
bnbenBengalisource only
bsbosBosniansource only
bgbulBulgarianyes
mymyaBurmesesource only
yueyueCantoneseyes
cacatCatalanyes
cebcebCebuanosource only
nynyaChichewasource only
hrhrvCroatianyes
cscesCzechsource only
dadanDanishyes
nlnldDutchyes
enengEnglishyes
etestEstoniansource only
filfilFilipinosource only
fifinFinnishsource only
frfraFrenchyes
fffulFulahsource only
glglgGaliciansource only
lglugGandasource only
kakatGeorgiansource only
dedeuGermanyes
elellGreekyes
gugujGujaratisource only
hahauHausasource only
hehebHebrewsource only
hihinHindisource only
huhunHungariansource only
isislIcelandicsource only
igiboIgbosource only
idindIndonesianyes
gagleIrishsource only
ititaItalianyes
jajpnJapaneseyes
jvjavJavanesesource only
keakeaKabuverdianusource only
knkanKannadasource only
kkkazKazakhyes
kmkhmKhmersource only
kokorKoreanyes
kukurKurdishsource only
kykirKyrgyzsource only
lolaoLaosource only
lvlavLatvianyes
lnlinLingalasource only
ltlitLithuanianyes
luoluoLuosource only
lbltzLuxembourgishsource only
mkmkdMacedoniansource only
msmsaMalaysource only
mlmalMalayalamsource only
mtmltMaltesesource only
zhzhoMandarinyes
mimriMāorisource only
mrmarMarathisource only
mnmonMongoliansource only
nenepNepalisource only
nsonsoNorthern Sothosource only
nonorNorwegianyes
ocociOccitansource only
ororiOdiasource only
pspusPashtosource only
fafasPersiansource only
plpolPolishsource only
ptporPortugueseyes
papanPunjabisource only
roronRomaniansource only
rurusRussianyes
srsrpSerbianyes
snsnaShonasource only
sdsndSindhisource only
skslkSlovakyes
slslvSloveniansource only
sosomSomalisource only
esspaSpanishyes
swswaSwahilisource only
svsweSwedishyes
tatamTamilsource only
tgtgkTajiksource only
tetelTelugusource only
ththaThaiyes
trturTurkishsource only
ukukrUkrainianyes
umbumbUmbundusource only
ururdUrdusource only
uzuzbUzbeksource only
vivieVietnameseyes
cycymWelshsource only
wowolWolofsource only
xhxhoXhosasource only
zuzulZulusource only

03.The 32 live source languages (experimental)

A live session (experimental, coming soon) is planned to take its feed in any of these and dub it into the same 30 output languages as uploads; 18 are output languages too, the rest source only. Norwegian Nynorsk (nn) is a live-only source code, not in the upload list.

TABLE 03 · LIVE SOURCE LANGUAGES (ALPHABETICAL)
CODELANGUAGEOUTPUT
afAfrikaanssource only
arArabicyes
yueCantoneseyes
caCatalanyes
daDanishyes
nlDutchyes
enEnglishyes
etEstoniansource only
fiFinnishsource only
frFrenchyes
glGaliciansource only
deGermanyes
heHebrewsource only
hiHindisource only
itItalianyes
jaJapaneseyes
koKoreanyes
zhMandarinyes
mrMarathisource only
noNorwegianyes
nnNorwegian Nynorsksource only
faPersiansource only
ptPortugueseyes
roRomaniansource only
ruRussianyes
esSpanishyes
svSwedishyes
trTurkishsource only
urUrdusource only
viVietnameseyes
xhXhosasource only
zuZulusource only

04.GET /v1/languages

GET/v1/languages
curl https://api.thefamiliarlab.com/v1/languages \
  -H "Authorization: Bearer $FAMILIAR_API_KEY"

{
  "data": [
    { "code": "en", "name": "English", "output": true,  "tier": 1,    "live_source": true },
    { "code": "th", "name": "Thai",    "output": true,  "tier": 1,    "live_source": false },
    { "code": "tr", "name": "Turkish", "output": false, "tier": null, "live_source": true },
    { "code": "sw", "name": "Swahili", "output": false, "tier": null, "live_source": false },
    …
  ]
}

output is true for the 30 languages a dub can come out in and false for source-only ones (tier then null); live_source marks the 32 planned live source languages (experimental) and does not affect uploads. Serve language pickers from this endpoint: new languages appear here first, tier moves as quality improves, and additions are non-breaking (Versioning & stability).

05.Using the codes

target_langs takes up to 29 of the 30output codes; a source can't be its own target and a source-only code can't be a target (422 unsupported_language). source_lang accepts any of the 99 source codes on uploads and any of the 32 live source codes on a live session; it defaults to auto -- detection is per job and per live session, so a channel that mixes source languages needs no configuration.

06.Access

The API is enterprise-only: private access under a Studio contract, with volume pricing, raised limits, ProRes masters on request, and a named point of contact. Book a call and your key is issued with the contract.