Sign up for free

Adding captions

Add captions to your videos through a single API call, and avoid having to manually embed captions for your videos.

How to upload captions

The captions are uploaded per language. You can upload different captions for each language. You only need to include these attributes in your POST request to the Captions endpoint:

FieldType
videoIdStringThe unique identifier for the video you want to add a caption to.
languageStringA valid language identifier using IETF language tags. You can use primary subtags like en (English), extended subtags like fr-CA (French, Canada), or region subtags like zh-Hans-CN (Simplified Chinese used in the PRC).
- This parameter only accepts dashes for separators, for example fr-CA. If you use a different separator in your request, the API returns an error.
- When the value in your request does not match any covered language, the API returns an error.
- You can find the list of supported language tags here.
fileFileThe video text track in VTT format only.

Generate captions automatically

api.video's AI-driven transcript generation enables you to automatically create captions for your videos. Your audience will be able to select the generated captions during video playback.

Subscribe to the video.caption.generated webhook to get a notification when an automatically generated caption is complete.

Supported caption file formats

Currently only VTT file format is supported.

Supported caption language tags

Open this list to see the supported language tags for captions.
LanguagesTagNative name
AfrikaansafAfrikaans
Afrikaans (Namibia)af-NAAfrikaans (Namibië)
Afrikaans (South Africa)af-ZAAfrikaans (Suid-Afrika)
AkanakAkan
Akan (Ghana)ak-GHAkan (Gaana)
Amharicamአማርኛ
Amharic (Ethiopia)am-ETአማርኛ (ኢትዮጵያ)
Arabicarالعربية
Arabic (world)ar-001العربية (العالم)
Arabic (United Arab Emirates)ar-AEالعربية (الإمارات العربية المتحدة)
Arabic (Bahrain)ar-BHالعربية (البحرين)
Arabic (Djibouti)ar-DJالعربية (جيبوتي)
Arabic (Algeria)ar-DZالعربية (الجزائر)
Arabic (Egypt)ar-EGالعربية (مصر)
Arabic (Western Sahara)ar-EHالعربية (الصحراء الغربية)
Arabic (Eritrea)ar-ERالعربية (إريتريا)
Arabic (Israel)ar-ILالعربية (إسرائيل)
Arabic (Iraq)ar-IQالعربية (العراق)
Arabic (Jordan)ar-JOالعربية (الأردن)
Arabic (Comoros)ar-KMالعربية (جزر القمر)
Arabic (Kuwait)ar-KWالعربية (الكويت)
Arabic (Lebanon)ar-LBالعربية (لبنان)
Arabic (Libya)ar-LYالعربية (ليبيا)
Arabic (Morocco)ar-MAالعربية (المغرب)
Arabic (Mauritania)ar-MRالعربية (موريتانيا)
Arabic (Oman)ar-OMالعربية (عُمان)
Arabic (Palestinian Territories)ar-PSالعربية (الأراضي الفلسطينية)
Arabic (Qatar)ar-QAالعربية (قطر)
Arabic (Saudi Arabia)ar-SAالعربية (المملكة العربية السعودية)
Arabic (Sudan)ar-SDالعربية (السودان)
Arabic (Somalia)ar-SOالعربية (الصومال)
Arabic (South Sudan)ar-SSالعربية (جنوب السودان)
Arabic (Syria)ar-SYالعربية (سوريا)
Arabic (Chad)ar-TDالعربية (تشاد)
Arabic (Tunisia)ar-TNالعربية (تونس)
Arabic (Yemen)ar-YEالعربية (اليمن)
Assameseasঅসমীয়া
Assamese (India)as-INঅসমীয়া (ভাৰত)
AzerbaijaniazAzərbaycan
Azerbaijani (Azerbaijan)az-AZAzərbaycan (Azərbaycan)
Azerbaijani (Cyrillic)az-CyrlАзәрбајҹан (Кирил)
Azerbaijani (Cyrillic, Azerbaijan)az-Cyrl-AZАзәрбајҹан (Кирил, Азәрбајҹан)
Azerbaijani (Latin)az-LatnAzərbaycan (latın)
Azerbaijani (Latin, Azerbaijan)az-Latn-AZAzərbaycan (latın, Azərbaycan)
BelarusianbeБеларуская
Belarusian (Belarus)be-BYБеларуская (Беларусь)
BulgarianbgБългарски
Bulgarian (Bulgaria)bg-BGБългарски (България)
BambarabmBamanakan
Bambara (Mali)bm-MLBamanakan (Mali)
Banglabnবাংলা
Bangla (Bangladesh)bn-BDবাংলা (বাংলাদেশ)
Bangla (India)bn-INবাংলা (ভারত)
Tibetanboབོད་སྐད་
Tibetan (China)bo-CNབོད་སྐད་ (རྒྱ་ནག)
Tibetan (India)bo-INབོད་སྐད་ (རྒྱ་གར་)
BretonbrBrezhoneg
Breton (France)br-FRBrezhoneg (Frañs)
BosnianbsBosanski
Bosnian (Bosnia & Herzegovina)bs-BABosanski (Bosna i Hercegovina)
Bosnian (Cyrillic)bs-CyrlБосански (ћирилица)
Bosnian (Cyrillic, Bosnia & Herzegovina)bs-Cyrl-BAБосански (ћирилица, Босна и Херцеговина)
Bosnian (Latin)bs-LatnBosanski (latinica)
Bosnian (Latin, Bosnia & Herzegovina)bs-Latn-BABosanski (latinica, Bosna i Hercegovina)
CatalancaCatalà
Catalan (Andorra)ca-ADCatalà (Andorra)
Catalan (Spain)ca-ESCatalà (Espanya)
Catalan (France)ca-FRCatalà (França)
Catalan (Italy)ca-ITCatalà (Itàlia)
ChechenceНохчийн
Chechen (Russia)ce-RUНохчийн (Росси)
CzechcsČeština
Czech (Czechia)cs-CZČeština (Česko)
ChuvashcvЧӑваш
Chuvash (Russia)cv-RUЧӑваш (Раҫҫей)
WelshcyCymraeg
Welsh (United Kingdom)cy-GBCymraeg (Y Deyrnas Unedig)
DanishdaDansk
Danish (Denmark)da-DKDansk (Danmark)
Danish (Greenland)da-GLDansk (Grønland)
GermandeDeutsch
German (Austria)de-ATDeutsch (Österreich)
German (Belgium)de-BEDeutsch (Belgien)
German (Switzerland)de-CHDeutsch (Schweiz)
German (Germany)de-DEDeutsch (Deutschland)
German (Italy)de-ITDeutsch (Italien)
German (Liechtenstein)de-LIDeutsch (Liechtenstein)
German (Luxembourg)de-LUDeutsch (Luxemburg)
Dzongkhadzརྫོང་ཁ
Dzongkha (Bhutan)dz-BTརྫོང་ཁ། (འབྲུག།)
EweeeEʋegbe
Ewe (Ghana)ee-GHEʋegbe (Ghana nutome)
Ewe (Togo)ee-TGEʋegbe (Togo nutome)
GreekelΕλληνικά
Greek (Cyprus)el-CYΕλληνικά (Κύπρος)
Greek (Greece)el-GRΕλληνικά (Ελλάδα)
EnglishenEnglish
English (world)en-001English (world)
English (Europe)en-150English (Europe)
English (United Arab Emirates)en-AEEnglish (United Arab Emirates)
English (Antigua & Barbuda)en-AGEnglish (Antigua & Barbuda)
English (Anguilla)en-AIEnglish (Anguilla)
English (American Samoa)en-ASEnglish (American Samoa)
English (Austria)en-ATEnglish (Austria)
English (Australia)en-AUEnglish (Australia)
English (Barbados)en-BBEnglish (Barbados)
English (Belgium)en-BEEnglish (Belgium)
English (Burundi)en-BIEnglish (Burundi)
English (Bermuda)en-BMEnglish (Bermuda)
English (Bahamas)en-BSEnglish (Bahamas)
English (Botswana)en-BWEnglish (Botswana)
English (Belize)en-BZEnglish (Belize)
English (Canada)en-CAEnglish (Canada)
English (Cocos [Keeling] Islands)en-CCEnglish (Cocos [Keeling] Islands)
English (Switzerland)en-CHEnglish (Switzerland)
English (Cook Islands)en-CKEnglish (Cook Islands)
English (Cameroon)en-CMEnglish (Cameroon)
English (Christmas Island)en-CXEnglish (Christmas Island)
English (Cyprus)en-CYEnglish (Cyprus)
English (Germany)en-DEEnglish (Germany)
en-DGen-DGen-DG
English (Denmark)en-DKEnglish (Denmark)
English (Dominica)en-DMEnglish (Dominica)
English (Eritrea)en-EREnglish (Eritrea)
English (Finland)en-FIEnglish (Finland)
English (Fiji)en-FJEnglish (Fiji)
English (Falkland Islands)en-FKEnglish (Falkland Islands)
English (Micronesia)en-FMEnglish (Micronesia)
English (United Kingdom)en-GBEnglish (United Kingdom)
English (Grenada)en-GDEnglish (Grenada)
English (Guernsey)en-GGEnglish (Guernsey)
English (Ghana)en-GHEnglish (Ghana)
English (Gibraltar)en-GIEnglish (Gibraltar)
English (Gambia)en-GMEnglish (Gambia)
English (Guam)en-GUEnglish (Guam)
English (Guyana)en-GYEnglish (Guyana)
English (Hong Kong SAR China)en-HKEnglish (Hong Kong SAR China)
English (Indonesia)en-IDEnglish (Indonesia)
English (Ireland)en-IEEnglish (Ireland)
English (Israel)en-ILEnglish (Israel)
English (Isle of Man)en-IMEnglish (Isle of Man)
English (India)en-INEnglish (India)
English (British Indian Ocean Territory)en-IOEnglish (British Indian Ocean Territory)
English (Jersey)en-JEEnglish (Jersey)
English (Jamaica)en-JMEnglish (Jamaica)
English (Kenya)en-KEEnglish (Kenya)
English (Kiribati)en-KIEnglish (Kiribati)
English (St. Kitts & Nevis)en-KNEnglish (St. Kitts & Nevis)
English (Cayman Islands)en-KYEnglish (Cayman Islands)
English (St. Lucia)en-LCEnglish (St. Lucia)
English (Liberia)en-LREnglish (Liberia)
English (Lesotho)en-LSEnglish (Lesotho)
English (Madagascar)en-MGEnglish (Madagascar)
English (Marshall Islands)en-MHEnglish (Marshall Islands)
English (Macao SAR China)en-MOEnglish (Macao SAR China)
English (Northern Mariana Islands)en-MPEnglish (Northern Mariana Islands)
English (Montserrat)en-MSEnglish (Montserrat)
English (Malta)en-MTEnglish (Malta)
English (Mauritius)en-MUEnglish (Mauritius)
English (Maldives)en-MVEnglish (Maldives)
English (Malawi)en-MWEnglish (Malawi)
English (Malaysia)en-MYEnglish (Malaysia)
English (Namibia)en-NAEnglish (Namibia)
English (Norfolk Island)en-NFEnglish (Norfolk Island)
English (Nigeria)en-NGEnglish (Nigeria)
en-NHen-NHen-NH
English (Netherlands)en-NLEnglish (Netherlands)
English (Nauru)en-NREnglish (Nauru)
English (Niue)en-NUEnglish (Niue)
English (New Zealand)en-NZEnglish (New Zealand)
English (Papua New Guinea)en-PGEnglish (Papua New Guinea)
English (Philippines)en-PHEnglish (Philippines)
English (Pakistan)en-PKEnglish (Pakistan)
English (Pitcairn Islands)en-PNEnglish (Pitcairn Islands)
English (Puerto Rico)en-PREnglish (Puerto Rico)
English (Palau)en-PWEnglish (Palau)
en-RHen-RHen-RH
English (Rwanda)en-RWEnglish (Rwanda)
English (Solomon Islands)en-SBEnglish (Solomon Islands)
English (Seychelles)en-SCEnglish (Seychelles)
English (Sudan)en-SDEnglish (Sudan)
English (Sweden)en-SEEnglish (Sweden)
English (Singapore)en-SGEnglish (Singapore)
English (St. Helena)en-SHEnglish (St. Helena)
English (Slovenia)en-SIEnglish (Slovenia)
English (Sierra Leone)en-SLEnglish (Sierra Leone)
English (South Sudan)en-SSEnglish (South Sudan)
English (Sint Maarten)en-SXEnglish (Sint Maarten)
English (Eswatini)en-SZEnglish (Eswatini)
English (Turks & Caicos Islands)en-TCEnglish (Turks & Caicos Islands)
English (Tokelau)en-TKEnglish (Tokelau)
English (Tonga)en-TOEnglish (Tonga)
English (Trinidad & Tobago)en-TTEnglish (Trinidad & Tobago)
English (Tuvalu)en-TVEnglish (Tuvalu)
English (Tanzania)en-TZEnglish (Tanzania)
English (Uganda)en-UGEnglish (Uganda)
English (U.S. Outlying Islands)en-UMEnglish (U.S. Outlying Islands)
English (United States)en-USEnglish (United States)
en-US-POSIXen-US-POSIXen-US-POSIX
English (St. Vincent & Grenadines)en-VCEnglish (St. Vincent & Grenadines)
English (British Virgin Islands)en-VGEnglish (British Virgin Islands)
English (U.S. Virgin Islands)en-VIEnglish (U.S. Virgin Islands)
English (Vanuatu)en-VUEnglish (Vanuatu)
English (Samoa)en-WSEnglish (Samoa)
English (South Africa)en-ZAEnglish (South Africa)
English (Zambia)en-ZMEnglish (Zambia)
English (Zimbabwe)en-ZWEnglish (Zimbabwe)
EsperantoeoEsperanto
Esperanto (world)eo-001Esperanto (mondo)
SpanishesEspañol
Spanish (Latin America)es-419Español (Latinoamérica)
Spanish (Argentina)es-AREspañol (Argentina)
Spanish (Bolivia)es-BOEspañol (Bolivia)
Spanish (Brazil)es-BREspañol (Brasil)
Spanish (Belize)es-BZEspañol (Belice)
Spanish (Chile)es-CLEspañol (Chile)
Spanish (Colombia)es-COEspañol (Colombia)
Spanish (Costa Rica)es-CREspañol (Costa Rica)
Spanish (Cuba)es-CUEspañol (Cuba)
Spanish (Dominican Republic)es-DOEspañol (República Dominicana)
es-EAes-EAes-EA
Spanish (Ecuador)es-ECEspañol (Ecuador)
Spanish (Spain)es-ESEspañol (España)
Spanish (Equatorial Guinea)es-GQEspañol (Guinea Ecuatorial)
Spanish (Guatemala)es-GTEspañol (Guatemala)
Spanish (Honduras)es-HNEspañol (Honduras)
es-ICes-ICes-IC
Spanish (Mexico)es-MXEspañol (México)
Spanish (Nicaragua)es-NIEspañol (Nicaragua)
Spanish (Panama)es-PAEspañol (Panamá)
Spanish (Peru)es-PEEspañol (Perú)
Spanish (Philippines)es-PHEspañol (Filipinas)
Spanish (Puerto Rico)es-PREspañol (Puerto Rico)
Spanish (Paraguay)es-PYEspañol (Paraguay)
Spanish (El Salvador)es-SVEspañol (El Salvador)
Spanish (United States)es-USEspañol (Estados Unidos)
Spanish (Uruguay)es-UYEspañol (Uruguay)
Spanish (Venezuela)es-VEEspañol (Venezuela)
EstonianetEesti
Estonian (Estonia)et-EEEesti (Eesti)
BasqueeuEuskara
Basque (Spain)eu-ESEuskara (Espainia)
Persianfaفارسی
Persian (Afghanistan)fa-AFفارسی (افغانستان)
Persian (Iran)fa-IRفارسی (ایران)
FulaffPulaar
Fula (Adlam)ff-Adlm𞤆𞤵𞤤𞤢𞤪 (𞤀𞤁𞤂𞤢𞤃)
Fula (Adlam, Burkina Faso)ff-Adlm-BF𞤆𞤵𞤤𞤢𞤪 (𞤀𞤁𞤂𞤢𞤃⹁ 𞤄𞤵𞤪𞤳𞤭𞤲𞤢 𞤊𞤢𞤧𞤮𞥅)
Fula (Adlam, Cameroon)ff-Adlm-CM𞤆𞤵𞤤𞤢𞤪 (𞤀𞤁𞤂𞤢𞤃⹁ 𞤑𞤢𞤥𞤢𞤪𞤵𞥅𞤲)
Fula (Adlam, Ghana)ff-Adlm-GH𞤆𞤵𞤤𞤢𞤪 (𞤀𞤁𞤂𞤢𞤃⹁ 𞤘𞤢𞤲𞤢)
Fula (Adlam, Gambia)ff-Adlm-GM𞤆𞤵𞤤𞤢𞤪 (𞤀𞤁𞤂𞤢𞤃⹁ 𞤘𞤢𞤥𞤦𞤭𞤴𞤢)
Fula (Adlam, Guinea)ff-Adlm-GN𞤆𞤵𞤤𞤢𞤪 (𞤀𞤁𞤂𞤢𞤃⹁ 𞤘𞤭𞤲𞤫)
Fula (Adlam, Guinea-Bissau)ff-Adlm-GW𞤆𞤵𞤤𞤢𞤪 (𞤀𞤁𞤂𞤢𞤃⹁ 𞤘𞤭𞤲𞤫-𞤄𞤭𞤧𞤢𞤱𞤮𞥅)
Fula (Adlam, Liberia)ff-Adlm-LR𞤆𞤵𞤤𞤢𞤪 (𞤀𞤁𞤂𞤢𞤃⹁ 𞤂𞤢𞤦𞤭𞤪𞤭𞤴𞤢𞥄)
Fula (Adlam, Mauritania)ff-Adlm-MR𞤆𞤵𞤤𞤢𞤪 (𞤀𞤁𞤂𞤢𞤃⹁ 𞤃𞤮𞤪𞤼𞤢𞤲𞤭𞥅)
Fula (Adlam, Niger)ff-Adlm-NE𞤆𞤵𞤤𞤢𞤪 (𞤀𞤁𞤂𞤢𞤃⹁ 𞤐𞤭𞥅𞤶𞤫𞤪)
Fula (Adlam, Nigeria)ff-Adlm-NG𞤆𞤵𞤤𞤢𞤪 (𞤀𞤁𞤂𞤢𞤃⹁ 𞤐𞤢𞤶𞤫𞤪𞤭𞤴𞤢𞥄)
Fula (Adlam, Sierra Leone)ff-Adlm-SL𞤆𞤵𞤤𞤢𞤪 (𞤀𞤁𞤂𞤢𞤃⹁ 𞤅𞤢𞤪𞤢𞤤𞤮𞤲)
Fula (Adlam, Senegal)ff-Adlm-SN𞤆𞤵𞤤𞤢𞤪 (𞤀𞤁𞤂𞤢𞤃⹁ 𞤅𞤫𞤲𞤫𞤺𞤢𞥄𞤤)
Fula (Cameroon)ff-CMPulaar (Kameruun)
Fula (Guinea)ff-GNPulaar (Gine)
Fula (Latin)ff-LatnFula (Latin)
Fula (Latin, Burkina Faso)ff-Latn-BFFula (Latin, Burkina Faso)
Fula (Latin, Cameroon)ff-Latn-CMFula (Latin, Cameroon)
Fula (Latin, Ghana)ff-Latn-GHFula (Latin, Ghana)
Fula (Latin, Gambia)ff-Latn-GMFula (Latin, Gambia)
Fula (Latin, Guinea)ff-Latn-GNFula (Latin, Guinea)
Fula (Latin, Guinea-Bissau)ff-Latn-GWFula (Latin, Guinea-Bissau)
Fula (Latin, Liberia)ff-Latn-LRFula (Latin, Liberia)
Fula (Latin, Mauritania)ff-Latn-MRFula (Latin, Mauritania)
Fula (Latin, Niger)ff-Latn-NEFula (Latin, Niger)
Fula (Latin, Nigeria)ff-Latn-NGFula (Latin, Nigeria)
Fula (Latin, Sierra Leone)ff-Latn-SLFula (Latin, Sierra Leone)
Fula (Latin, Senegal)ff-Latn-SNFula (Latin, Senegal)
Fula (Mauritania)ff-MRPulaar (Muritani)
Fula (Senegal)ff-SNPulaar (Senegaal)
FinnishfiSuomi
Finnish (Finland)fi-FISuomi (Suomi)
FaroesefoFøroyskt
Faroese (Denmark)fo-DKFøroyskt (Danmark)
Faroese (Faroe Islands)fo-FOFøroyskt (Føroyar)
FrenchfrFrançais
French (Belgium)fr-BEFrançais (Belgique)
French (Burkina Faso)fr-BFFrançais (Burkina Faso)
French (Burundi)fr-BIFrançais (Burundi)
French (Benin)fr-BJFrançais (Bénin)
French (St. Barthélemy)fr-BLFrançais (Saint-Barthélemy)
French (Canada)fr-CAFrançais (Canada)
French (Congo - Kinshasa)fr-CDFrançais (Congo-Kinshasa)
French (Central African Republic)fr-CFFrançais (République centrafricaine)
French (Congo - Brazzaville)fr-CGFrançais (Congo-Brazzaville)
French (Switzerland)fr-CHFrançais (Suisse)
French (Côte d’Ivoire)fr-CIFrançais (Côte d’Ivoire)
French (Cameroon)fr-CMFrançais (Cameroun)
French (Djibouti)fr-DJFrançais (Djibouti)
French (Algeria)fr-DZFrançais (Algérie)
French (France)fr-FRFrançais (France)
French (Gabon)fr-GAFrançais (Gabon)
French (French Guiana)fr-GFFrançais (Guyane française)
French (Guinea)fr-GNFrançais (Guinée)
French (Guadeloupe)fr-GPFrançais (Guadeloupe)
French (Equatorial Guinea)fr-GQFrançais (Guinée équatoriale)
French (Haiti)fr-HTFrançais (Haïti)
French (Comoros)fr-KMFrançais (Comores)
French (Luxembourg)fr-LUFrançais (Luxembourg)
French (Morocco)fr-MAFrançais (Maroc)
French (Monaco)fr-MCFrançais (Monaco)
French (St. Martin)fr-MFFrançais (Saint-Martin)
French (Madagascar)fr-MGFrançais (Madagascar)
French (Mali)fr-MLFrançais (Mali)
French (Martinique)fr-MQFrançais (Martinique)
French (Mauritania)fr-MRFrançais (Mauritanie)
French (Mauritius)fr-MUFrançais (Maurice)
French (New Caledonia)fr-NCFrançais (Nouvelle-Calédonie)
French (Niger)fr-NEFrançais (Niger)
French (French Polynesia)fr-PFFrançais (Polynésie française)
French (St. Pierre & Miquelon)fr-PMFrançais (Saint-Pierre-et-Miquelon)
French (Réunion)fr-REFrançais (La Réunion)
French (Rwanda)fr-RWFrançais (Rwanda)
French (Seychelles)fr-SCFrançais (Seychelles)
French (Senegal)fr-SNFrançais (Sénégal)
French (Syria)fr-SYFrançais (Syrie)
French (Chad)fr-TDFrançais (Tchad)
French (Togo)fr-TGFrançais (Togo)
French (Tunisia)fr-TNFrançais (Tunisie)
French (Vanuatu)fr-VUFrançais (Vanuatu)
French (Wallis & Futuna)fr-WFFrançais (Wallis-et-Futuna)
French (Mayotte)fr-YTFrançais (Mayotte)
Western FrisianfyFrysk
Western Frisian (Netherlands)fy-NLFrysk (Nederlân)
IrishgaGaeilge
Irish (United Kingdom)ga-GBGaeilge (an Ríocht Aontaithe)
Irish (Ireland)ga-IEGaeilge (Éire)
Scottish GaelicgdGàidhlig
Scottish Gaelic (United Kingdom)gd-GBGàidhlig (An Rìoghachd Aonaichte)
GalicianglGalego
Galician (Spain)gl-ESGalego (España)
Gujaratiguગુજરાતી
Gujarati (India)gu-INગુજરાતી (ભારત)
ManxgvGaelg
Manx (Isle of Man)gv-IMGaelg (Ellan Vannin)
HausahaHausa
Hausa (Ghana)ha-GHHausa (Gana)
Hausa (Niger)ha-NEHausa (Nijar)
Hausa (Nigeria)ha-NGHausa (Nijeriya)
Hebrewheעברית
Hebrew (Israel)he-ILעברית (ישראל)
Hindihiहिन्दी
Hindi (India)hi-INहिन्दी (भारत)
Hindi (Latin)hi-Latnहिन्दी (लैटिन)
Hindi (Latin, India)hi-Latn-INहिन्दी (लैटिन, भारत)
CroatianhrHrvatski
Croatian (Bosnia & Herzegovina)hr-BAHrvatski (Bosna i Hercegovina)
Croatian (Croatia)hr-HRHrvatski (Hrvatska)
HungarianhuMagyar
Hungarian (Hungary)hu-HUMagyar (Magyarország)
ArmenianhyՀայերեն
Armenian (Armenia)hy-AMՀայերեն (Հայաստան)
InterlinguaiaInterlingua
Interlingua (world)ia-001Interlingua (Mundo)
IndonesianidIndonesia
Indonesian (Indonesia)id-IDIndonesia (Indonesia)
InterlingueieInterlingue
Interlingue (Estonia)ie-EEInterlingue (Estonia)
IgboigIgbo
Igbo (Nigeria)ig-NGIgbo (Naịjịrịa)
Sichuan Yiiiꆈꌠꉙ
Sichuan Yi (China)ii-CNꆈꌠꉙ (ꍏꇩ)
ininin
in-IDin-IDin-ID
IcelandicisÍslenska
Icelandic (Iceland)is-ISÍslenska (Ísland)
ItalianitItaliano
Italian (Switzerland)it-CHItaliano (Svizzera)
Italian (Italy)it-ITItaliano (Italia)
Italian (San Marino)it-SMItaliano (San Marino)
Italian (Vatican City)it-VAItaliano (Città del Vaticano)
iwiwiw
iw-ILiw-ILiw-IL
Japaneseja日本語
Japanese (Japan)ja-JP日本語 (日本)
ja-JP-TRADITIONALja-JP-TRADITIONALja-JP-TRADITIONAL
JavanesejvJawa
Javanese (Indonesia)jv-IDJawa (Indonésia)
Georgiankaქართული
Georgian (Georgia)ka-GEქართული (საქართველო)
KikuyukiGikuyu
Kikuyu (Kenya)ki-KEGikuyu (Kenya)
KazakhkkҚазақ тілі
Kazakh (Kazakhstan)kk-KZҚазақ тілі (Қазақстан)
KalaallisutklKalaallisut
Kalaallisut (Greenland)kl-GLKalaallisut (Kalaallit Nunaat)
Khmerkmខ្មែរ
Khmer (Cambodia)km-KHខ្មែរ (កម្ពុជា)
Kannadaknಕನ್ನಡ
Kannada (India)kn-INಕನ್ನಡ (ಭಾರತ)
Koreanko한국어
Korean (China)ko-CN한국어(중국)
Korean (North Korea)ko-KP한국어(조선민주주의인민공화국)
Korean (South Korea)ko-KR한국어(대한민국)
Kashmiriksکٲشُر
Kashmiri (Arabic)ks-Arabکٲشُر (عربی)
Kashmiri (Arabic, India)ks-Arab-INکٲشُر (عربی, ہِندوستان)
Kashmiri (Devanagari)ks-Devaकॉशुर (देवनागरी)
Kashmiri (Devanagari, India)ks-Deva-INकॉशुर (देवनागरी, हिंदोस्तान)
Kashmiri (India)ks-INکٲشُر (ہِندوستان)
KurdishkuKurdî [kurmancî]
Kurdish (Türkiye)ku-TRKurdî [kurmancî] (Tirkiye)
CornishkwKernewek
Cornish (United Kingdom)kw-GBKernewek (Rywvaneth Unys)
KyrgyzkyКыргызча
Kyrgyz (Kyrgyzstan)ky-KGКыргызча (Кыргызстан)
LuxembourgishlbLëtzebuergesch
Luxembourgish (Luxembourg)lb-LULëtzebuergesch (Lëtzebuerg)
GandalgLuganda
Ganda (Uganda)lg-UGLuganda (Yuganda)
LingalalnLingála
Lingala (Angola)ln-AOLingála (Angóla)
Lingala (Congo - Kinshasa)ln-CDLingála (Republíki ya Kongó Demokratíki)
Lingala (Central African Republic)ln-CFLingála (Repibiki ya Afríka ya Káti)
Lingala (Congo - Brazzaville)ln-CGLingála (Kongo)
Laoloລາວ
Lao (Laos)lo-LAລາວ (ລາວ)
LithuanianltLietuvių
Lithuanian (Lithuania)lt-LTLietuvių (Lietuva)
Luba-KatangaluTshiluba
Luba-Katanga (Congo - Kinshasa)lu-CDTshiluba (Ditunga wa Kongu)
LatvianlvLatviešu
Latvian (Latvia)lv-LVLatviešu (Latvija)
MalagasymgMalagasy
Malagasy (Madagascar)mg-MGMalagasy (Madagasikara)
MāorimiMāori
Māori (New Zealand)mi-NZMāori (Aotearoa)
MacedonianmkМакедонски
Macedonian (North Macedonia)mk-MKМакедонски (Северна Македонија)
Malayalammlമലയാളം
Malayalam (India)ml-INമലയാളം (ഇന്ത്യ)
MongolianmnМонгол
Mongolian (Mongolia)mn-MNМонгол (Монгол)
momomo
Marathimrमराठी
Marathi (India)mr-INमराठी (भारत)
MalaymsMelayu
Malay (Brunei)ms-BNMelayu (Brunei)
Malay (Indonesia)ms-IDMelayu (Indonesia)
Malay (Malaysia)ms-MYMelayu (Malaysia)
Malay (Singapore)ms-SGMelayu (Singapura)
MaltesemtMalti
Maltese (Malta)mt-MTMalti (Malta)
Burmesemyမြန်မာ
Burmese (Myanmar [Burma])my-MMမြန်မာ (မြန်မာ)
Norwegian BokmålnbNorwegian Bokmål
Norwegian Bokmål (Norway)nb-NONorwegian Bokmål (Norway)
Norwegian Bokmål (Svalbard & Jan Mayen)nb-SJNorwegian Bokmål (Svalbard & Jan Mayen)
North NdebelendIsiNdebele
North Ndebele (Zimbabwe)nd-ZWIsiNdebele (Zimbabwe)
Nepalineनेपाली
Nepali (India)ne-INनेपाली (भारत)
Nepali (Nepal)ne-NPनेपाली (नेपाल)
DutchnlNederlands
Dutch (Aruba)nl-AWNederlands (Aruba)
Dutch (Belgium)nl-BENederlands (België)
Dutch (Caribbean Netherlands)nl-BQNederlands (Caribisch Nederland)
Dutch (Curaçao)nl-CWNederlands (Curaçao)
Dutch (Netherlands)nl-NLNederlands (Nederland)
Dutch (Suriname)nl-SRNederlands (Suriname)
Dutch (Sint Maarten)nl-SXNederlands (Sint-Maarten)
Norwegian NynorsknnNorwegian Nynorsk
Norwegian Nynorsk (Norway)nn-NONorwegian Nynorsk (Norway)
NorwegiannoNorsk
Norwegian (Norway)no-NONorsk (Norge)
no-NO-NYno-NO-NYno-NO-NY
OccitanocOccitan
Occitan (Spain)oc-ESOccitan (Espanha)
Occitan (France)oc-FROccitan (França)
OromoomOromoo
Oromo (Ethiopia)om-ETOromoo (Itoophiyaa)
Oromo (Kenya)om-KEOromoo (Keeniyaa)
Odiaorଓଡ଼ିଆ
Odia (India)or-INଓଡ଼ିଆ (ଭାରତ)
OsseticosИрон
Ossetic (Georgia)os-GEИрон (Гуырдзыстон)
Ossetic (Russia)os-RUИрон (Уӕрӕсе)
Punjabipaਪੰਜਾਬੀ
Punjabi (Arabic)pa-Arabپنجابی (عربی)
Punjabi (Arabic, Pakistan)pa-Arab-PKپنجابی (عربی, پاکستان)
Punjabi (Gurmukhi)pa-Guruਪੰਜਾਬੀ (ਗੁਰਮੁਖੀ)
Punjabi (Gurmukhi, India)pa-Guru-INਪੰਜਾਬੀ (ਗੁਰਮੁਖੀ, ਭਾਰਤ)
Punjabi (India)pa-INਪੰਜਾਬੀ (ਭਾਰਤ)
Punjabi (Pakistan)pa-PKپنجابی (پاکستان)
PolishplPolski
Polish (Poland)pl-PLPolski (Polska)
Pashtopsپښتو
Pashto (Afghanistan)ps-AFپښتو (افغانستان)
Pashto (Pakistan)ps-PKپښتو (پاکستان)
PortugueseptPortuguês
Portuguese (Angola)pt-AOPortuguês (Angola)
Portuguese (Brazil)pt-BRPortuguês (Brasil)
Portuguese (Switzerland)pt-CHPortuguês (Suíça)
Portuguese (Cape Verde)pt-CVPortuguês (Cabo Verde)
Portuguese (Equatorial Guinea)pt-GQPortuguês (Guiné Equatorial)
Portuguese (Guinea-Bissau)pt-GWPortuguês (Guiné-Bissau)
Portuguese (Luxembourg)pt-LUPortuguês (Luxemburgo)
Portuguese (Macao SAR China)pt-MOPortuguês (Macau, RAE da China)
Portuguese (Mozambique)pt-MZPortuguês (Moçambique)
Portuguese (Portugal)pt-PTPortuguês (Portugal)
Portuguese (São Tomé & Príncipe)pt-STPortuguês (São Tomé e Príncipe)
Portuguese (Timor-Leste)pt-TLPortuguês (Timor-Leste)
QuechuaquRunasimi
Quechua (Bolivia)qu-BORunasimi (Bolivia)
Quechua (Ecuador)qu-ECRunasimi (Ecuador)
Quechua (Peru)qu-PERunasimi (Perú)
RomanshrmRumantsch
Romansh (Switzerland)rm-CHRumantsch (Svizra)
RundirnIkirundi
Rundi (Burundi)rn-BIIkirundi (Uburundi)
RomanianroRomână
Romanian (Moldova)ro-MDRomână (Republica Moldova)
Romanian (Romania)ro-RORomână (România)
RussianruРусский
Russian (Belarus)ru-BYРусский (Беларусь)
Russian (Kyrgyzstan)ru-KGРусский (Киргизия)
Russian (Kazakhstan)ru-KZРусский (Казахстан)
Russian (Moldova)ru-MDРусский (Молдова)
Russian (Russia)ru-RUРусский (Россия)
Russian (Ukraine)ru-UAРусский (Украина)
KinyarwandarwKinyarwanda
Kinyarwanda (Rwanda)rw-RWKinyarwanda (U Rwanda)
Sanskritsaसंस्कृत भाषा
Sanskrit (India)sa-INसंस्कृत भाषा (भारतः)
SardinianscSardu
Sardinian (Italy)sc-ITSardu (Itàlia)
Sindhisdسنڌي
Sindhi (Arabic)sd-Arabسنڌي (عربي)
Sindhi (Arabic, Pakistan)sd-Arab-PKسنڌي (عربي, پاڪستان)
Sindhi (Devanagari)sd-Devaसिन्धी (देवनागिरी)
Sindhi (Devanagari, India)sd-Deva-INसिन्धी (देवनागिरी, भारत)
Sindhi (India)sd-INसिन्धी (भारत)
Sindhi (Pakistan)sd-PKسنڌي (پاڪستان)
Northern SamiseDavvisámegiella
Northern Sami (Finland)se-FIDavvisámegiella (Suopma)
Northern Sami (Norway)se-NODavvisámegiella (Norga)
Northern Sami (Sweden)se-SEDavvisámegiella (Ruoŧŧa)
SangosgSängö
Sango (Central African Republic)sg-CFSängö (Ködörösêse tî Bêafrîka)
Serbo-CroatianshSrpskohrvatski
Serbo-Croatian (Bosnia & Herzegovina)sh-BASrpskohrvatski (Bosna i Hercegovina)
sh-CSsh-CSsh-CS
sh-YUsh-YUsh-YU
Sinhalasiසිංහල
Sinhala (Sri Lanka)si-LKසිංහල (ශ්‍රී ලංකාව)
SlovakskSlovenčina
Slovak (Slovakia)sk-SKSlovenčina (Slovensko)
SlovenianslSlovenščina
Slovenian (Slovenia)sl-SISlovenščina (Slovenija)
ShonasnChiShona
Shona (Zimbabwe)sn-ZWChiShona (Zimbabwe)
SomalisoSoomaali
Somali (Djibouti)so-DJSoomaali (Jabuuti)
Somali (Ethiopia)so-ETSoomaali (Itoobiya)
Somali (Kenya)so-KESoomaali (Kenya)
Somali (Somalia)so-SOSoomaali (Soomaaliya)
AlbaniansqShqip
Albanian (Albania)sq-ALShqip (Shqipëri)
Albanian (North Macedonia)sq-MKShqip (Maqedonia e Veriut)
sq-XKsq-XKsq-XK
SerbiansrСрпски
Serbian (Bosnia & Herzegovina)sr-BAСрпски (Босна и Херцеговина)
sr-CSsr-CSsr-CS
Serbian (Cyrillic)sr-CyrlСрпски (ћирилица)
Serbian (Cyrillic, Bosnia & Herzegovina)sr-Cyrl-BAСрпски (ћирилица, Босна и Херцеговина)
sr-Cyrl-CSsr-Cyrl-CSsr-Cyrl-CS
Serbian (Cyrillic, Montenegro)sr-Cyrl-MEСрпски (ћирилица, Црна Гора)
Serbian (Cyrillic, Serbia)sr-Cyrl-RSСрпски (ћирилица, Србија)
sr-Cyrl-XKsr-Cyrl-XKsr-Cyrl-XK
sr-Cyrl-YUsr-Cyrl-YUsr-Cyrl-YU
Serbian (Latin)sr-LatnSrpski (latinica)
Serbian (Latin, Bosnia & Herzegovina)sr-Latn-BASrpski (latinica, Bosna i Hercegovina)
sr-Latn-CSsr-Latn-CSsr-Latn-CS
Serbian (Latin, Montenegro)sr-Latn-MESrpski (latinica, Crna Gora)
Serbian (Latin, Serbia)sr-Latn-RSSrpski (latinica, Srbija)
sr-Latn-XKsr-Latn-XKsr-Latn-XK
sr-Latn-YUsr-Latn-YUsr-Latn-YU
Serbian (Montenegro)sr-MESrpski (Crna Gora)
Serbian (Serbia)sr-RSСрпски (Србија)
sr-XKsr-XKsr-XK
sr-YUsr-YUsr-YU
SundanesesuBasa Sunda
Sundanese (Indonesia)su-IDBasa Sunda (Indonesia)
Sundanese (Latin)su-LatnBasa Sunda (Latin)
Sundanese (Latin, Indonesia)su-Latn-IDBasa Sunda (Latin, Indonesia)
SwedishsvSvenska
Swedish (Åland Islands)sv-AXSvenska (Åland)
Swedish (Finland)sv-FISvenska (Finland)
Swedish (Sweden)sv-SESvenska (Sverige)
SwahiliswKiswahili
Swahili (Congo - Kinshasa)sw-CDKiswahili (Jamhuri ya Kidemokrasia ya Kongo)
Swahili (Kenya)sw-KEKiswahili (Kenya)
Swahili (Tanzania)sw-TZKiswahili (Tanzania)
Swahili (Uganda)sw-UGKiswahili (Uganda)
Tamiltaதமிழ்
Tamil (India)ta-INதமிழ் (இந்தியா)
Tamil (Sri Lanka)ta-LKதமிழ் (இலங்கை)
Tamil (Malaysia)ta-MYதமிழ் (மலேசியா)
Tamil (Singapore)ta-SGதமிழ் (சிங்கப்பூர்)
Teluguteతెలుగు
Telugu (India)te-INతెలుగు (భారతదేశం)
TajiktgТоҷикӣ
Tajik (Tajikistan)tg-TJТоҷикӣ (Тоҷикистон)
Thaithไทย
Thai (Thailand)th-THไทย (ไทย)
th-TH-TRADITIONALth-TH-TRADITIONALth-TH-TRADITIONAL
Tigrinyatiትግርኛ
Tigrinya (Eritrea)ti-ERትግርኛ (ኤርትራ)
Tigrinya (Ethiopia)ti-ETትግርኛ (ኢትዮጵያ)
TurkmentkTürkmen dili
Turkmen (Turkmenistan)tk-TMTürkmen dili (Türkmenistan)
TagalogtlTagalog
Tagalog (Philippines)tl-PHTagalog (Philippines)
TongantoLea fakatonga
Tongan (Tonga)to-TOLea fakatonga (Tonga)
TurkishtrTürkçe
Turkish (Cyprus)tr-CYTürkçe (Kıbrıs)
Turkish (Türkiye)tr-TRTürkçe (Türkiye)
TatarttТатар
Tatar (Russia)tt-RUТатар (Россия)
Uyghurugئۇيغۇرچە
Uyghur (China)ug-CNئۇيغۇرچە (جۇڭگو)
UkrainianukУкраїнська
Ukrainian (Ukraine)uk-UAУкраїнська (Україна)
Urduurاردو
Urdu (India)ur-INاردو (بھارت)
Urdu (Pakistan)ur-PKاردو (پاکستان)
UzbekuzO‘zbek
Uzbek (Afghanistan)uz-AFاوزبیک (افغانستان)
Uzbek (Arabic)uz-Arabاوزبیک (عربی)
Uzbek (Arabic, Afghanistan)uz-Arab-AFاوزبیک (عربی, افغانستان)
Uzbek (Cyrillic)uz-CyrlЎзбекча (Кирил)
Uzbek (Cyrillic, Uzbekistan)uz-Cyrl-UZЎзбекча (Кирил, Ўзбекистон)
Uzbek (Latin)uz-LatnO‘zbek (lotin)
Uzbek (Latin, Uzbekistan)uz-Latn-UZO‘zbek (lotin, Oʻzbekiston)
Uzbek (Uzbekistan)uz-UZO‘zbek (Oʻzbekiston)
VietnameseviTiếng Việt
Vietnamese (Vietnam)vi-VNTiếng Việt (Việt Nam)
WolofwoWolof
Wolof (Senegal)wo-SNWolof (Senegaal)
XhosaxhIsiXhosa
Xhosa (South Africa)xh-ZAIsiXhosa (EMzantsi Afrika)
Yiddishyiייִדיש
Yiddish (Ukraine)yi-UAייִדיש (אוקראַינע)
YorubayoÈdè Yorùbá
Yoruba (Benin)yo-BJÈdè Yorùbá (Bɛ̀nɛ̀)
Yoruba (Nigeria)yo-NGÈdè Yorùbá (Nàìjíríà)
ZhuangzaVahcuengh
Zhuang (China)za-CNVahcuengh (Cunghgoz)
Chinesezh中文
Chinese (China)zh-CN中文(中国)
Chinese (Hong Kong SAR China)zh-HK中文(中國香港特別行政區)
Chinese (Simplified)zh-Hans中文(简体)
Chinese (Simplified, China)zh-Hans-CN中文(简体,中国)
Chinese (Simplified, Hong Kong SAR China)zh-Hans-HK中文(简体,中国香港特别行政区)
Chinese (Simplified, Macao SAR China)zh-Hans-MO中文(简体,中国澳门特别行政区)
Chinese (Simplified, Singapore)zh-Hans-SG中文(简体,新加坡)
Chinese (Traditional)zh-Hant中文(繁體)
Chinese (Traditional, Hong Kong SAR China)zh-Hant-HK中文(繁體字,中國香港特別行政區)
Chinese (Traditional, Macao SAR China)zh-Hant-MO中文(繁體,中國澳門特別行政區)
Chinese (Traditional, Taiwan)zh-Hant-TW中文(繁體,台灣)
Chinese (Macao SAR China)zh-MO中文(中國澳門特別行政區)
Chinese (Singapore)zh-SG中文(新加坡)
Chinese (Taiwan)zh-TW中文(台灣)
ZuluzuIsiZulu
Zulu (South Africa)zu-ZAIsiZulu (iNingizimu Afrika)

WebVTT file formatting

WebVTT is a format for displaying timed text tracks for captions or chapters. It is a text based format, which must be encoded using UTF-8. Check out the Mozilla developer guide for more information about WebVTT.

To ensure that you use the correct formatting in your VTT file, api.video recommends using a parser to check for errors before you upload the file. Click here for a free online VTT parser.

Incorrect VTT file formatting

The api.video API does not return an error for incorrectly formatted VTT files. The response from the API will be 200, however, the captions will not be displayed.

The VTT file has an extension .vtt and the format is as in the example below:

WEBVTT

00:01.000 --> 00:04.000
- Adding captions is easy.

00:05.000 --> 00:09.000
- You only need a single API request.
- And a properly formatted VTT file.

Tutorials & Resources

Was this page helpful?