Overview
Transform long-form videos into engaging short clips using AI. This endpoint analyzes your video content and automatically extracts the most engaging moments, creating viral-ready clips optimized for social media platforms.Rate Limiting
This endpoint is rate limited to 10 requests per minute per API key.Request Body
YouTube URL to process (alternative to uploadId)
Upload ID from a previously uploaded file (alternative to sourceUrl)
Whether to automatically reframe clips for different aspect ratios
Output orientation for the clips
Output resolution for the clips
Caption style preset ID (use null to disable captions)
Whether to add emojis to captions
Whether to highlight keywords in captions
Primary language of the video content (auto-detected if not provided)
Language to translate captions to
Video genre for better AI analysis
Start time in seconds for processing (processes entire video if not specified)
End time in seconds for processing (processes entire video if not specified)
You must provide either
sourceUrl or uploadId, but not both.Video Requirements
Duration
Minimum: 2 minutes
Maximum: 3 hours
Maximum: 3 hours
File Size
Maximum: 5 GB
Format
MP4 or MOV with valid video streams
Content Type
Works best with dialogue-rich content
Plan Limitations
| Plan | Max Resolution | Features |
|---|---|---|
| Free | 720p | Basic clipping, limited minutes |
| Creator | 1080p | All features, more minutes |
| Studio | 4K (2160p) | All features, unlimited processing |
Response
Unique project identifier
Project title (usually the filename)
Thumbnail URL for the project
Duration in seconds that will be billed to your account
Current processing status
processing- Video is being analyzed and clips are being generatedcompleted- All clips have been generated successfullyfailed- Processing failed due to an error
Type of project (always “clipping” for this endpoint)
Source of the video content
user_upload- Uploaded fileyoutube- YouTube URL
Video genre used for AI analysis
Array of identified topics in the video
Array of clip duration preferences
Start time in seconds for processing (null if entire video)
End time in seconds for processing (null if entire video)
Whether clips will be automatically reframed
Output resolution for the clips
Output orientation for the clips
Caption style preset ID (null if captions disabled)
Whether captions are enabled
Whether emojis are added to captions
Whether keyword highlighting is enabled
Primary language of the video content
Target dubbing language (null if not applicable)
Whether transcription will be translated
Array of languages for translation
Video file metadata including duration, resolution, format, etc.
Project URLs and assets (populated when processing completes)
Unix timestamp when the project was created
Unix timestamp when the project was last updated
Example Request
Example Response
Processing Workflow
- Upload Analysis - Video is analyzed for content, speakers, and key moments
- AI Clipping - Our AI identifies the most engaging segments for clips
- Processing - Clips are generated with your specified settings
- Completion - Use Get Project Status to monitor progress
- Download - Retrieve clips using Get Project Clips
Best Practices
- Content Quality: Videos with clear speech and engaging content produce better clips
- Duration: Longer videos (10+ minutes) typically yield more clip options
- Genre Selection: Choose the correct genre for optimal AI analysis
- Caption Presets: Use captions for better engagement on social platforms
- Resolution: Higher resolutions are better for professional content but take longer to process
Use Cases
Content Creators
Turn long-form content into social media clips
Educators
Extract key teaching moments from lectures
Marketers
Create promotional clips from webinars and presentations
Podcasters
Generate video clips from audio-only content with visualizations