Skip to main content
This guide shows you how to transform long-form videos into short, engaging clips perfect for social media. Use AI to automatically extract the most impactful moments from webinars, interviews, lectures, or any long video content.

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
  • 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:
  1. Video Access - Your source video is downloaded and analyzed
  2. Audio Transcription - AI transcribes the audio content
  3. Content Analysis - Speech patterns, visual changes, and content relevance are analyzed
  4. Highlight Detection - Key moments and engaging segments are identified
  5. Clip Extraction - Short clips are generated from the highlights
  6. Enhancement - Clips are optimized with captions and formatting
  7. 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

Main Request Parameters

Scene Parameters

Media Repurpose Settings (Optional)

Supported Video Formats

Best Format: Use MP4 (H.264 codec) for the best balance of quality, compatibility, and processing speed.

Ideal Clip Durations by Platform

Common Use Cases

Webinar Highlights for LinkedIn

Result: Key insights extracted as 30-90 second clips perfect for LinkedIn.

Podcast to Social Media Clips

Result: Best moments from podcast as shareable social clips.

Interview Highlights for YouTube Shorts

Result: Most engaging interview segments as short-form content.

Educational Content for TikTok

Result: Educational highlights perfect for TikTok’s short format.

Best Practices

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
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
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
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 will not expire during processing
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

Problem: The API cannot download or process your video.Solution:
  • Verify URL is publicly accessible (test in incognito browser)
  • Ensure it is 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)
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
Problem: AI does not 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
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
Problem: Auto-generated captions do not 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
Problem: API completes but does not return highlight clips.Solution:
  • Verify videoToVideo parameter is set to true
  • Check source video contains clear speech
  • Ensure video is not purely music or sound effects
  • Try with different source video to test
  • Verify source video is not 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: