Style library

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.

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:

{
  "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.

Overview

Guides

Endpoints