Upload a subtitle file

Uploads an SRT or WebVTT subtitle. SRT input is converted to WebVTT. The maximum configured file size is 500 KB.

The current backend source requires a deployment fix before this operation can run.

POST /v1/subtitles/upload

Upload a subtitle file

cURL

curl --request POST \
  --url https://api.videobase.com/v1/subtitles/upload \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-Api-Key: <api-key>' \
  --form id=a1b2c3d4e5f6 \
  --form 'language=<string>' \
  --form file='@example-file'

200

{
  "subtitle": {
    "language": "<string>",
    "url": "<string>"
  }
}

Authorizations

ApiKeyHeaderApiKeyQuery

X-Api-Key · string · header · required

Recommended. Your 16-character Videobase API key.

Body

multipart/form-data

id · string · required

Twelve-character Videobase video or remote-upload identifier.

Required string length: 12

Pattern: ^\w{12}$

Example:

"a1b2c3d4e5f6"

language · string · required

Subtitle language identifier containing letters, numbers, or underscores.

Pattern: ^\w+$

file · file · required

SRT or WebVTT subtitle file, up to 500 KB.

Response

200

application/json

Queued subtitle.

subtitle · object · required

Show child attributes