Styles

Every video is made in one style, passed as style on POST /v1/videos. The styles are the ones on scenema.ai/styles, searched the same way, plus the styles your workspace made in Scenema.

List styles

GET https://api.scenema.ai/v1/styles

Query	Meaning
q	Keywords for the look or the topic, e.g. whiteboard science lesson or flat vector SaaS onboarding. Matches names, tags, use cases, categories and palettes.
category	Only styles in this category, e.g. Whiteboard.
page, perPage	Pagination; perPage up to 100, 10 by default.

curl -H "Authorization: Bearer $SCENEMA_API_KEY" \
  "https://api.scenema.ai/v1/styles?q=whiteboard%20science%20lesson&perPage=5"

The response holds items, total, page and perPage. Without q, the list is every style, featured ones first.

Get a style

GET https://api.scenema.ai/v1/styles/{slug} returns one style by its slug or its id: a Scenema style, or one of the workspace’s own. Any other returns 404 STYLE_NOT_FOUND.

Style fields

Field	Meaning
slug	What to pass as style on POST /v1/videos. Pass slug/palette (a palette’s slug) to make the video in that palette.
id	The style’s id; style takes it too.
name, tagline, description	The style’s name, a one line summary and a longer description.
category, tags	The style’s category and its tags.
thumbnailUrl	A frame in this style.
palettes	The style’s palettes: slug, name, isDefault, a frame (thumbnailUrl) and the colors as hex.
custom	true for one of your workspace’s own styles.

A video reports its style the same way: style is the slug and styleId the id (Videos).