Clip

The Clip entity represents derivative short-form content extracted from full ContentProduction records.

Overview

Fields

Field	Type	Description
name	varchar	Clip title
status	enum	Production status
hookQuote	text	Key quote / hook text
duration	int	Length in seconds
aspectRatio	enum	Video format
videoUrlLandscape	url	16:9 version URL
videoUrlPortrait	url	9:16 version URL
videoUrlSquare	url	1:1 version URL
targetPlatforms	multiEnum	Destination platforms
thumbnailUrl	url	Thumbnail image

Clip Status

Status	Description	Next Action
Draft	Moment identified	Define hook, trim points
Editing	Being edited	Add captions, effects
Ready	Ready for distribution	Queue for platforms
Published	Distributed	Track performance

Aspect Ratios

Ratio	Dimensions	Platforms
16:9 Landscape	1920×1080	YouTube, Rumble, Facebook
9:16 Portrait	1080×1920	Shorts, Reels, TikTok
1:1 Square	1080×1080	Instagram Feed, X

Target Platforms

Platform	Preferred Ratio	Max Duration
YouTube Shorts	9:16	60 seconds
Instagram Reels	9:16	90 seconds
TikTok	9:16	10 minutes
X/Twitter	16:9 or 1:1	2:20
Facebook Reels	9:16	90 seconds

AI-Powered Features

The Bridge includes AI analysis for clips:

Clip Analysis Features

• Hook Detection — Identify compelling opening moments
• Quote Extraction — Find quotable statements
• Emotion Analysis — Detect high-energy moments
• Topic Clustering — Group related moments

Workflow Integration

Creating Clips

Distributing Clips

API Operations

Create Clip

POST /api/v1/Clip
Content-Type: application/json

{
  "name": "Best Quote - Episode 42",
  "contentProductionId": "content-id-here",
  "status": "Draft",
  "hookQuote": "This is the most important thing I've learned...",
  "duration": 45,
  "aspectRatio": "Portrait 9:16",
  "targetPlatforms": ["YouTube Shorts", "Instagram Reels", "TikTok"]
}

Request AI Analysis

POST /clips/analyze
Content-Type: application/json

{
  "contentProductionId": "content-id-here",
  "transcript": "Full transcript text...",
  "maxClips": 5
}

Response:

{
  "suggestedClips": [
    {
      "hookQuote": "This is the most important...",
      "startTime": 245,
      "endTime": 290,
      "confidence": 0.92,
      "reason": "Strong emotional hook with actionable insight"
    }
  ]
}

Update Clip URLs

PUT /api/v1/Clip/{id}
Content-Type: application/json

{
  "status": "Ready",
  "videoUrlPortrait": "https://cdn.example.com/clip-portrait.mp4",
  "videoUrlLandscape": "https://cdn.example.com/clip-landscape.mp4",
  "thumbnailUrl": "https://cdn.example.com/clip-thumb.jpg"
}

Best Practices

Strong Hooks

Start clips with the most compelling moment. The first 3 seconds determine if viewers stay.

Multiple Formats

Create all three aspect ratios to maximize platform reach without re-editing.

Caption Everything

Add captions for accessibility and silent autoplay. Use the caption pipeline in Bridge.

Duration Limits

Know your platform limits. YouTube Shorts max is 60 seconds—don't exceed it.

Repurpose Strategically

A single episode can yield 5-10 clips. Plan clip content during editing.

Related

• ContentProduction — Source content
• SocialPost — Distribution posts
• Social Workflow — Posting clips
• Video Editor — Editing clips