Pipeline
Upload or import
Upload via multipart (large files) or paste a public URL. Autoposting downloads, normalizes, and extracts duration metadata.
AI detection
Audio is transcribed with word-level timestamps. AI scores segments for virality, hook strength, and retention. Face detection builds per-speaker crop keyframes.
Review candidates
AI-ranked clip candidates appear with scores for
hook, retention, clarity, and visual. Select a candidate and choose a layout.Render
Dispatch a render job. Track progress via
GET /clips/:id. Credits are deducted only on successful completion.Import via URL
GET /clips/:id for processing status — the status field moves from processing to ready when candidates are generated.
Layouts
| Layout | Best For |
|---|---|
| Focus | Single or dominant speaker — dynamic reframe |
| Split | Two-person conversations — speakers stacked top/bottom |
| Split + Caption Bar | Heavy dialogue — dedicated caption bar below split |
| Cinema | B-roll, demos, wide shots — full source frame |
| Auto | Let AI pick based on face count and scene analysis |
Split layout requires at least 5 qualifying two-face frames spanning more than 3 seconds. If
splitEligible: false, Split options are disabled and render falls back to Focus.Submit a Render
Output Formats
| Composition | Resolution | Platforms |
|---|---|---|
clip-vertical | 1080×1920 | TikTok, Instagram Reels, YouTube Shorts |
clip-horizontal | 1920×1080 | YouTube, LinkedIn |
clip-square | 1080×1080 | Instagram feed, LinkedIn square |
Credit Costs
| Operation | Credits |
|---|---|
| Render (per clip) | Based on duration and resolution |
| Failed render | 0 — credits are never deducted on failure |
Status Reference
| Clip Status | Description |
|---|---|
uploading | Multipart upload in progress |
processing | Transcription, AI detection, face tracking running |
ready | Candidates generated and available for review |
failed | Processing pipeline failed |
| Candidate Status | Description |
|---|---|
generated | AI candidate, not yet rendered |
rendering | Render job dispatched |
completed | Render finished — download URL available |
failed | Render failed — no credits consumed |
Posts
Publish rendered clips as scheduled posts across platforms.
Brands
Set default clip templates and aspect ratios per brand.
Carousels
Turn topics into multi-slide carousels instead of video clips.
API Reference
Upload, render, and download endpoint reference.