What You’ll Learn
Video Repurposing
Convert long videos into short clips
AI Highlights
Automatically detect key moments
Social Ready
Perfect for TikTok, Reels, Shorts
Auto Captions
Subtitles generated automatically
Before You Begin
Make sure you have:- A Pictory API key (get one here)
- Node.js or Python installed on your machine
- Long-form video accessible via public URL
- Understanding of target platform requirements
How Video-to-Shorts Works
When you convert a long video to short clips:- Video Access - Your source video is downloaded and analyzed
- Audio Transcription - AI transcribes the audio content
- Content Analysis - Speech patterns, visual changes, and content relevance are analyzed
- Highlight Detection - Key moments and engaging segments are identified
- Clip Extraction - Short clips are generated from the highlights
- Enhancement - Clips are optimized with captions and formatting
- Video Rendering - Final short clips are ready for download
The source video must be accessible via a public URL. Processing time depends on video length - expect approximately 1-2 minutes of processing for every minute of source video.
Complete Example
Understanding the Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
videoName | string | Yes | A descriptive name for your video project |
url | string | Yes | Public URL to the long-form source video file |
videoToVideo | boolean | Yes | Set to true to enable video repurposing mode |
Supported Video Formats
| Format | Extension | Description | Quality |
|---|---|---|---|
| MP4 | .mp4 | Most common format (recommended) | Excellent |
| MOV | .mov | Apple QuickTime format | Excellent |
| AVI | .avi | Windows video format | Good |
| MKV | .mkv | Matroska multimedia container | Excellent |
| WebM | .webm | Web video format | Good |
| WMV | .wmv | Windows Media Video | Good |
Ideal Clip Durations by Platform
| Platform | Ideal Duration | Maximum Length | Notes |
|---|---|---|---|
| TikTok | 15-60 seconds | 10 minutes | Shorter is better (under 60s) |
| Instagram Reels | 15-90 seconds | 90 seconds | Sweet spot: 30-60 seconds |
| YouTube Shorts | 15-60 seconds | 60 seconds | Must be vertical or square |
| Twitter/X | 15-45 seconds | 2 minutes 20 seconds | Concise content performs best |
| 30-90 seconds | 10 minutes | Professional, value-focused | |
| 30-90 seconds | 240 minutes | Attention span: first 3 seconds crucial |
Common Use Cases
Webinar Highlights for LinkedIn
Podcast to Social Media Clips
Interview Highlights for YouTube Shorts
Educational Content for TikTok
Best Practices
Choose Quality Source Videos
Choose Quality Source Videos
Start with high-quality source material:
- Resolution: 1080p or higher recommended
- Audio Quality: Clear speech with minimal background noise
- Lighting: Well-lit content produces better clips
- Composition: Centered subjects work best for crops
- Engagement: Videos with natural segment breaks work better
Optimize Video Length
Optimize Video Length
Select appropriate source video duration:
- 10-30 Minutes: Ideal length for extracting multiple clips
- Under 10 Minutes: May produce fewer highlight options
- Over 60 Minutes: Consider splitting into segments first
- Clear Sections: Videos with distinct topics produce better clips
- Pacing: Varied pacing helps AI identify engaging moments
Ensure Clean Audio
Ensure Clean Audio
Audio quality directly affects clip selection:
- Clear Speech: AI relies on transcription for context
- Minimal Noise: Reduce background sounds
- Good Microphones: Use quality recording equipment
- One Speaker: Single speaker is easier to process
- Natural Pauses: Helps AI identify segment boundaries
Make Videos Publicly Accessible
Make Videos Publicly Accessible
Ensure your video file can be accessed:
- Cloud Storage: Upload to Google Drive, Dropbox, AWS S3, or CDN
- Public Link: Generate direct, public download URL
- No Authentication: URL must work without login
- Test Access: Open in incognito browser to verify
- Stable URL: Ensure link won’t expire during processing
Plan for Platform Requirements
Plan for Platform Requirements
Consider your target platform:
- Aspect Ratio: 9:16 (vertical) for TikTok, Reels, Shorts
- Duration: Match platform limits (15-60s typical)
- Captions: Auto-generated captions included
- Branding: Add logos and brand elements
- Hook: First 3 seconds crucial for retention
Troubleshooting
Error: Unable to access video file
Error: Unable to access video file
Problem: The API cannot download or process your video.Solution:
- Verify URL is publicly accessible (test in incognito browser)
- Ensure it’s a direct download link, not streaming or preview link
- For Google Drive: Share → “Anyone with the link” → Copy link
- For Dropbox: Create link → change “dl=0” to “dl=1” in URL
- Check file hasn’t been deleted or moved
- Verify video format is supported (MP4, MOV, AVI, MKV, WebM)
Processing takes very long
Processing takes very long
Problem: Job status shows “in-progress” for extended periods.Solution:
- Processing time is proportional to video length
- Expected times:
- 10-minute video: 15-20 minutes processing
- 30-minute video: 30-45 minutes processing
- 60-minute video: 60-90 minutes processing
- Large file sizes take longer to download
- Check status every 5-10 seconds (not more frequently)
- If stuck for 2x expected time, contact support with job ID
Generated clips miss important moments
Generated clips miss important moments
Problem: AI doesn’t extract the segments you expected.Solution:
- AI identifies engaging moments based on multiple factors
- Ensure important moments have:
- Clear, distinct speech
- Visual changes or action
- Natural pauses before/after
- Energy in delivery
- Consider manually selecting specific segments instead
- Longer source videos give more clip options
Clips have poor audio quality
Clips have poor audio quality
Problem: Generated clips have muffled or unclear audio.Solution:
- Check source video audio quality
- Use higher bitrate audio in source (128kbps minimum)
- Reduce background noise in source video
- Ensure consistent audio levels throughout
- Re-export source video with better audio settings
- Try audio enhancement tools before uploading
Transcription is inaccurate
Transcription is inaccurate
Problem: Auto-generated captions don’t match audio.Solution:
- Improve source audio quality
- Reduce background music volume
- Ensure clear speech (not too fast)
- Minimize overlapping speakers
- Check for audio distortion or clipping
- Consider professional audio editing
No clips generated
No clips generated
Problem: API completes but doesn’t return highlight clips.Solution:
- Verify videoToVideo parameter is set to true
- Check source video contains clear speech
- Ensure video isn’t purely music or sound effects
- Try with different source video to test
- Verify source video isn’t corrupted
- Contact support if issue persists with valid content
Next Steps
Enhance your short-form videos with these features:Background Music
Add music to your short clips
Custom Captions
Customize auto-generated captions
Brand Settings
Apply consistent branding to clips
Logo Watermark
Add your logo to all clips
API Reference
For complete technical details, see:- Render Storyboard Video - Full API specification
- Get Job Status - Monitor job status and progress
