API Reference

Art styles

An art style is how every scene of an AI video V3 is drawn, learned from a video you uploaded rather than picked from a fixed list. This lists the ones your workspace can use, so you can name one when creating a video.

GET/v1/art-styles

List art styles

The styles Vsub published, plus the ones your workspace built. Styles that are still building are left out, so every id here is ready to draw with.

Response fields

styles[].idrequired

string

What to pass as artStyleId when creating an AI video V3.

styles[].namerequired

string

The name shown on the style in the app.

styles[].publishedrequired

boolean

True for a style Vsub published for everyone, false for one your workspace built and only your token can use.

styles[].previewUrl

string

A generated still showing what the style looks like.

styles[].sampleVideoUrlsrequired

string[]

Short videos made in this style. Empty when none were attached to it.

styles[].createdAtrequired

string

When the style finished building, as an ISO timestamp.

Request

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

Response 200

{
  "styles": [
    {
      "id": "6f1d0b74-9a2e-4f3c-8b51-2d7c9e40a1b8",
      "name": "Whiteboard explainer",
      "published": true,
      "previewUrl": "https://files.vsub.io/art-styles/6f1d0b74-sample.png",
      "sampleVideoUrls": ["https://files.vsub.io/art-styles/6f1d0b74-sample.mp4"],
      "createdAt": "2026-07-19T11:04:52.000Z"
    },
    {
      "id": "b83c2a10-5e77-42d9-9c04-1f6ba8d33e27",
      "name": "Our channel look",
      "published": false,
      "sampleVideoUrls": [],
      "createdAt": "2026-08-02T15:41:07.000Z"
    }
  ]
}

Building a style is done in the app: you upload a video in the style you want, and Vsub learns how to split a script into scenes and how to draw them from it. This endpoint only reads them.

{ "styles": [ { "id": "6f1d0b74-9a2e-4f3c-8b51-2d7c9e40a1b8", "name": "Whiteboard explainer", "published": true, "previewUrl": "https://files.vsub.io/art-styles/6f1d0b74-sample.png", "sampleVideoUrls": ["https://files.vsub.io/art-styles/6f1d0b74-sample.mp4"], "createdAt": "2026-07-19T11:04:52.000Z" }, { "id": "b83c2a10-5e77-42d9-9c04-1f6ba8d33e27", "name": "Our channel look", "published": false, "sampleVideoUrls": [], "createdAt": "2026-08-02T15:41:07.000Z" } ] }