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
exportOrientation
string
default: "landscape"
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
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 generated
completed
- All clips have been generated successfully
failed
- Processing failed due to an error
Type of project (always “clipping” for this endpoint)
Source of the video content
user_upload
- Uploaded file
youtube
- 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
cURL with Upload
cURL with YouTube
JavaScript
Python
PHP
curl -X POST "https://public.reap.video/api/v1/automation/create-clips" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"uploadId": "65f1a2b3c4d5e6f7a8b9c0d1",
"genre": "educational",
"exportResolution": 1080,
"exportOrientation": "portrait",
"reframeClips": true,
"captionsPreset": "system_beasty",
"enableEmojies": true,
"enableHighlights": true,
"language": "en"
}'
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