Marketing videos

​

Connect your assistant

Install one Knowlify connector using the MCP server URL provided by your administrator. Training and Marketing do not need separate connectors. Reconnect and explicitly approve Marketing videos, or Training and Marketing videos, on the Knowlify consent page. Your API key stays on Knowlify servers. This connection uses your personal workspace and account credits.

​

Video tools

​

Creation controls

Choose UGC, animated, commercial, or explainer. Supply a prompt and optionally duration, exact script, language, voice, audio mode, style, brand colors, fonts, and reference assets. The default requested duration is 30 seconds. Unsupported combinations return an error. UGC uses portrait. Commercial and explainer use landscape. Animated supports either aspect ratio. Quality is standard or max; provider-specific model names are not selectable through this release. Cinematic percentage is a planning target for compatible commercial/explainer workflows. Commercial videos support 10–40 seconds. Animated Standard supports 10–15 seconds or 30 seconds, with exact scripts limited to 15 seconds; Animated Max supports 10–30 seconds. Standard explainers support 30, 45, 60, 75, or 90 seconds and use a fixed animated pipeline; cinematic mix and locked exact scripts are unavailable for that combination. Account limits may impose a lower maximum. Only commercial/explainer accept audioMode (narrator or none). Omit audioMode and voiceId for UGC and animated videos, which use native provider audio. Translation and voice replacement currently require a supported narration script in a commercial/explainer video. Native-audio UGC and animated videos are rejected rather than returning unchanged speech. Voice replacement can change the final runtime to fit the new narration; poll status and use the returned video link. The three unfinished-generation limit is shared across Training and Marketing for each personal or organization API owner. Translation copies and supported retry/reformat operations also use generation capacity. Account entitlements, credit limits, and duration limits still apply.

​

Branding and reference images

Website lookup returns branding context; it does not create a saved Marketing brand. Apply colors and font family names explicitly. Import external product/person/background/logo images first, then use the returned Knowlify URL in referenceImageUrls. Identify the image role in its description, or use type: "logo" for a logo. Image imports accept direct public HTTPS PNG, JPEG, and WebP files up to 10 MB and 25 megapixels. Redirects, private addresses, SVG, and unsupported formats are rejected. Imports allow ten requests per minute per API owner. Video, document, and font-file references require supported public Knowlify-hosted asset URLs; this release does not import arbitrary external files in those formats.

​

Completion and recovery

Compatible clients display one player per accepted video and automatically check progress while the player is visible. Clients without embedded players must poll status. Closing the chat does not stop the render, but the player cannot send background notifications. A queued job is not a finished video. Completion requires is_complete and a usable video_url. If requires_action is true, follow next_action; retry failed scenes only when requested. Other review states may require opening Knowlify. Never automatically resubmit creation or an entire partially successful batch after an uncertain response. Check the existing jobs first. Reuse an edit’s idempotency key with the identical request when retrying an edit. Translations create a separate output; aspect changes update the existing video. Reformatting requires compatible editable source frames; packed outputs without those frames are rejected before work begins. Generate a new video in the desired format instead.

​

API routes

Authenticate with X-API-Key against your configured API environment. These routes enforce Marketing category and workspace ownership independently of the Training routes.