Documentation
Documentation
Batch Generation & Platform Pacing
Create video variations at scale and auto-optimize timing for each social platform.
Batch Variations
Start from a single base video and generate multiple variations by swapping scene content. Each variation becomes its own video record that you can preview, edit, and render independently.
How It Works
- • Provide a base video ID
- • Supply an array of variation overrides
- • Each override replaces specific scene slots
- • New video records are created automatically
Use Cases
- • A/B testing different headlines
- • Localised versions with region-specific stats
- • Content series with consistent branding
- • Platform-specific messaging variations
Example: Content Series
Base video: “Why BlackOps Center?”
Variation 1: Hook headline → “Save 10 hours a week”
Variation 2: Hook headline → “Your content, refined by AI”
Variation 3: Hook headline → “From idea to published in minutes”
Story Auto-Split
Instagram Stories require clips of 15 seconds or less. Auto-split takes your video and divides it into sequential story segments, each in portrait format (1080 x 1920).
Input
Any video with scenes totalling more than 15 seconds
Processing
Scenes grouped into ≤15s segments, format set to portrait
Output
Multiple video records, one per story slide
Platform Pacing Profiles
Each platform has different audience expectations for pacing. Apply a pacing profile to automatically adjust scene durations and transitions.
YouTube
Longer scenes, smooth fadesHook: 5s
Content: 8s
CTA: 6s
Transition: crossfade 0.8s
T
TikTok
Short, punchy cutsHook: 2s
Content: 4s
CTA: 3s
Transition: cut (none)
S
Instagram Stories
15s max per segmentHook: 2s
Content: 5s
CTA: 3s
Transition: slide 0.3s
in
Hook: 4s
Content: 7s
CTA: 5s
Transition: crossfade 0.6s
X
Twitter / X
Fast, attention-grabbingHook: 3s
Content: 5s
CTA: 4s
Transition: cut (none)
API & MCP Access
Both batch generation and platform pacing are available through the REST API and as MCP tools.
batch_videos
Two modes:
variations (clone + override slots) and story-split (auto-split into ≤15s segments).create_video with platform
Pass a
platform field when creating a video to auto-apply pacing.