メインコンテンツまでスキップ

Subtitles / Closed Captions

To embed the subtitles for a VOD, make a PUT request to the following API with specific VOD id provided:

PUT /bv/cms/v1/vods/:id/subtitles

Configure the subtitle request body with the following options:

AttributeTypeDescription
idstringSpecify the ID of the subtitle you would like to embed.

You can upload and obtain the ID for a subtile file using this API:
POST /bv/cms/v1/library/files:upload
  • Supported formats: srt, vtt
  • File size limitation: 3 MB
  • namestringThe name of the subtitle as it will appear on BlendVision console.
    codestringLanguage code follows the RFC 5646 standard, utilizing the shortest ISO 639-1 & ISO 3166-1 code. Please refer to Language Code Table as below.
    displaystringThe name of the subtitle language as it will appear on the player.

    Supported Language Code

    LanguageLanguage CodeLanguage
    Afrikaansaf-ZAAfrikaans (South Africa)
    Albaniansq-ALAlbanian (Albania)
    Amharicam-ETAmharic (Ethiopia)
    Arabicar-AEArabic (U.A.E.)
    Armenianhy-AMArmenian (Armenia)
    Assameseas-INAssamese (India)
    Bashkirba-RUBashkir (Russia)
    Basqueeu-ESBasque (Basque)
    Bengali (Bangla)bn-BDBengali (Bangladesh)
    Bhutanidz-BTBhutani (Bhutan)
    Biharibh-INBihari (India)
    Bislamabi-VUBislama(Vanuatu)
    Bretonbr-FRBreton (France)
    Bulgarianbg-BGBulgarian (Bulgaria)
    Burmesemy-MMBurmese (Myanmar)
    Byelorussian (Belarusian)be-BYBelarusian (Belarus)
    Catalanca-ESCatalan (Catalan)
    Chinese (Simplified)zh-CNChinese (China)
    Chinese (Traditional)zh-TWChinese (Taiwan)
    Corsicanco-FRCorsican (France)
    Croatianhr-HRCroatian (Croatia)
    Czechcs-CZCzech (Czech Republic)
    Danishda-DKDanish (Denmark)
    Dutchnl-NLDutch (Netherlands)
    Englishen-USEnglish (United States)
    Estonianet-EEEstonian (Estonia)
    Fijianfj-FJFijian (Fiji)
    Finnishfi-FIFinnish (Finland)
    Frenchfr-FRFrench (France)
    Frisianfy-NLFrisian (Netherlands)
    Galiciangl-ESGalician (Galician)
    Gaelic (Scottish)gd-IEGaelic (Ireland)
    Georgianka-GEGeorgian (Georgia)
    Germande-DEGerman (Germany)
    Greekel-GRGreek (Greece)
    Greenlandickl-GLGreenlandic (Greenland)
    Guaranign-PYGuarani (Paraguay)
    Gujaratigu-INGujarati (India)
    Hausaha-NGHausa (Nigeria)
    Hebrewhe-ILHebrew (Israel)
    Hindihi-INHindi (India)
    Hungarianhu-HUHungarian (Hungary)
    Icelandicis-ISIcelandic (Iceland)
    Indonesianid-IDIndonesian (Indonesia)
    Inuktitutiu-CAInuktitut (Canada)
    Irishga-IEIrish (Ireland)
    Italianit-ITItalian (Italy)
    Japaneseja-JPJapanese (Japan)
    Javaneseja-IDJavanese (Indonesia)
    Kannadakn-INKannada (India)
    Kashmiriks-INKashmiri (India)
    Koreanko-KRKorean (Korea)
    Malayms-MYMalay (Malaysia)
    Malayalamml-INMalayalam (India)
    Norwegiannn-NONorwegian (Norway)
    Polishpl-PLPolish (Poland)
    Portuguesept-PTPortuguese (Portugal)
    Romanianro-RORomanian (Romania)
    Russianru-RURussian (Russia)
    Slovaksk-SKSlovak (Slovakia)
    Spanishes-ESSpanish (Spain)
    Swedishsv-SESwedish (Sweden)
    Thaith-THThai (Thailand)
    Turkishtr-TRTurkish (Turkey)
    Turkmentk-TMTurkmen (Turkmenistan)
    Ukrainianuk-UAUkrainian (Ukraine)
    Vietnamesevi-VNVietnamese (Vietnam)
    Welshcy-GBWelsh (United Kingdom)

    Here is an example of a request body:

    {
    "subtitles":[
    {
    "id":"your-subtitle-id",
    "name":"English",
    "code":"en",
    "display":"English"
    }
    ]
    }