Themes

A theme is a whole visual and directing style — its templates, transitions, music and sound. A video uses its preset's theme unless the request sends one:

"theme": { "id": "…", "mode": "…", "level": "pro", "opening_line": true }

Which themes you have

GET /v1/themes lists the themes your account can use, each with:

• id, name, description and a preview.
• formats — landscape, shorts or both.
• modes — the theme's moods (id, name, description). Send one as mode, or "auto" to let VidNext pick per video.
• levels — pro, and mini where the theme has a lighter, faster version.
• supports_opening_line — whether the theme can open with "A ‹channel› original".

The list is always current: when a new theme is opened to your account it appears here, with no change on your side. A team key's member gets that member's themes (?member=).

Rules

• A theme you don't have is refused with theme_not_available; an unknown mode with unknown_theme_mode (it is never silently ignored).
• level: "mini" works only on themes that list it (level_not_supported otherwise).
• opening_line needs channel_id — the line names the channel.
• A themed video with no music chosen uses the theme's own score.