API Reference

Caption templates

A caption template is the look of the words on screen: the font, the colours, the highlight and the animation. This lists the ones your workspace can use, so you can name one when captioning a video.

GET/v1/caption-templates

List caption templates

The ones Vsub ships with, plus any style you saved in the editor.

Response fields

templates[].idrequired

number

What to pass as templateId when creating an Add Captions video.

templates[].namerequired

string

The name shown on the style in the editor.

templates[].customrequired

boolean

True for a style saved in your workspace, false for a built in one.

Request

curl "https://api.vsub.io/v1/caption-templates" \
  -H "Authorization: Bearer vp_a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90"

Response 200

{
  "templates": [
    { "id": 4821, "name": "Channel style", "custom": true },
    { "id": -2, "name": "Hormozi 3", "custom": false },
    { "id": -8, "name": "Podcast", "custom": false },
    { "id": -19, "name": "Mrbeast 2", "custom": false }
  ]
}

Built in styles are shared and keep the same negative id for everyone, styles saved in your workspace have a positive one and only work with your own token. Saving or editing a style is done in the app, this endpoint only reads them.