> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knowlify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Style library

> List and select built-in Training video styles

`GET {API_BASE}/v1/styles`

Send your `X-API-Key` header. The response contains `styles`, an array of selectable styles shared with the app's library. Each entry includes `id`, `name`, `description`, `preview_url`, `reference_image_url`, and `realistic`. Preview URLs currently show still images. Internal-only styles are excluded.

```bash theme={null}
curl --fail-with-body "$API_BASE/v1/styles" \
  -H "X-API-Key: $KNOWLIFY_API_KEY"
```

Use an exact returned ID as `style_library_id` in a video creation item:

```json theme={null}
{
  "videos": [{
    "task": "Create workplace safety training in watercolor style.",
    "video_duration_seconds": 30,
    "video_type": "training",
    "video_quality": "standard",
    "style_library_id": "watercolor"
  }]
}
```

The backend resolves the reference image and canonical visual instructions; clients do not need to copy them into the request. Unknown or internal-only IDs return 422 before jobs are queued. Omit the field to retain the existing automatic style selection.

A library selection takes priority over other style-reference selections. Brand colors and fonts remain separate controls. A style describes the visual look; it does not set the proportion of Remotion and cinematic scenes. Describe the desired scene mix in `task`.

This update requires the API service to deploy the style-library changes on `dev`. Check that the listing returns 200 before relying on `style_library_id`; older deployments may ignore unknown request fields. Production availability is not confirmed.