Klap Generate Shorts

End-to-end workflow for generating short-form video clips from YouTube videos using the Klap API. Handles the complete pipeline: submit → process → export → download → store.

What It Does

1. Submits a YouTube URL to Klap for AI-powered editing
2. Polls for processing completion (~5-30 minutes)
3. Lists all generated shorts with virality scores
4. Exports each short (creates download URLs)
5. Downloads videos locally
6. Stores everything in videotoshorts_agent database table
7. Sends desktop/webhook notifications when complete

How to Run

# Generate shorts from YouTube video
python3 skills/klap-generate-shorts/scripts/klap_generate_shorts.py "https://youtube.com/watch?v=VIDEO_ID"

# With custom user ID
python3 skills/klap-generate-shorts/scripts/klap_generate_shorts.py "https://youtube.com/watch?v=VIDEO_ID" --user-id 2

Configuration

Environment Variables

KLAP_API_KEY=xxx
DATABASE_URL=postgresql://...

# Optional
NOTIFICATION_WEBHOOK_URL=https://hooks.slack.com/services/...

Dependencies

pip install requests psycopg2-binary python-dotenv

Workflow Steps

1. Submit — POST /tasks/video-to-shorts with source URL, language, max duration, clip count
2. Poll Task — GET /tasks/{task_id} every 30 seconds until status = success
3. List Shorts — GET /projects/{folder_id} to get all generated clips
4. Export — POST /projects/{folderid}/{shortid}/exports for each short
5. Poll Export — GET .../exports/{export_id} every 5 seconds until download URL ready
6. Download — Save MP4 files locally
7. Store — Update database with video URLs and metadata

Klap API Settings

max_duration = 30          # Max seconds per clip
max_clip_count = 5         # Max clips to generate
language = "en"
intro_title = False        # No intro title overlay

Polling Configuration

TASK_POLL_INTERVAL = 30    # Seconds between task checks
EXPORT_POLL_INTERVAL = 5   # Seconds between export checks
MAX_TASK_POLLS = 60        # ~30 min max wait for processing
MAX_EXPORT_POLLS = 40      # ~3 min max wait for export

Database Table: videotoshorts_agent

Important Notes

• Processing takes 5-30 minutes depending on video length
• Each short must be exported individually before downloading
• Downloads go to shorts/klap{folderid}_{date}/ directory
• macOS desktop notification sent when complete
• Klap dashboard: https://klap.app/spaces/{folder_id}
• Handles API rate limits, timeouts, and export failures gracefully

Scripts