Skills
skills/docs.reap.video/Reap

Reap

SKILL.md

Capabilities

Reap Automation API enables agents to build powerful video automation workflows by integrating AI-powered video processing directly into applications and content pipelines. Agents can transform long-form videos into engaging short clips optimized for social media, automatically reframe content for different platforms, generate accurate captions with styling options, and create natural-sounding voice dubbing in 20+ languages. The API supports batch processing, real-time progress monitoring via webhooks, and works with both uploaded files and YouTube URLs.

Skills

Video Clipping

  • Create AI-powered clips: POST https://public.reap.video/api/v1/automation/create-clips
    • Extract engaging moments from long-form videos (2 min - 3 hours)
    • Specify genre (talking, educational, entertainment, business) for better AI analysis
    • Set output resolution (720p, 1080p, 1440p, 2160p) and orientation (landscape, portrait, square)
    • Enable automatic reframing for different aspect ratios
    • Process specific time ranges with selectedStart and selectedEnd parameters
    • Returns project ID and processing status
    • Typical processing time: 5-15 minutes

Caption Generation

  • Add AI-generated captions: POST https://public.reap.video/api/v1/automation/create-captions
    • Transcribe video audio with word-level timing accuracy
    • Apply caption style presets for consistent branding
    • Enable emoji support for contextual visual enhancement
    • Highlight keywords for emphasis
    • Translate captions to different languages
    • Works with videos 3 seconds to 15 minutes long
    • Typical processing time: 2-5 minutes

Video Reframing

  • Automatically reframe videos: POST https://public.reap.video/api/v1/automation/create-reframe
    • Convert landscape videos to portrait or square formats
    • AI-powered subject tracking keeps speakers centered
    • Intelligent object recognition maintains important visual elements
    • Optional automatic segmentation for longer videos
    • Supports videos 3 seconds to 15 minutes
    • Typical processing time: 3-8 minutes

Voice Dubbing

  • Create multilingual voiceovers: POST https://public.reap.video/api/v1/automation/create-dubbing
    • Dub videos in 20+ languages while preserving speaker tone and emotion
    • Specify source and target language codes (e.g., "en-US" to "es-MX")
    • Supports videos 3 seconds to 15 minutes
    • Automatic speech recognition and translation
    • Natural-sounding voice synthesis with cultural adaptation
    • Typical processing time: 10-20 minutes

File Management

  • Get secure upload URLs: POST https://public.reap.video/api/v1/automation/get-upload-url

    • Request presigned URLs for direct video uploads
    • Returns upload ID for use in project creation
    • Supports MP4 and MOV formats up to 5 GB

  • List uploaded files: GET https://public.reap.video/api/v1/automation/get-all-uploads

    • Retrieve paginated list of all uploaded videos
    • Track upload status and metadata
    • Reuse uploads across multiple projects

Project Management

  • Check project status: GET https://public.reap.video/api/v1/automation/get-project-status?projectId={id}

    • Lightweight endpoint for monitoring progress
    • Returns status: processing, completed, failed, or cancelled
    • Includes project type and source information

  • Get full project details: GET https://public.reap.video/api/v1/automation/get-project-details?projectId={id}

    • Retrieve complete project configuration and metadata
    • Access video metadata (duration, resolution, codec, bitrate)
    • Get project URLs and asset links

  • Retrieve generated clips: GET https://public.reap.video/api/v1/automation/get-project-clips?projectId={id}

    • Download clips with virality scores
    • Access clip titles, durations, and URLs
    • Get total clip count for batch processing

  • List all projects: GET https://public.reap.video/api/v1/automation/get-all-projects

    • Paginated list of all projects in studio
    • Filter by project type, status, and source
    • Track billing duration and processing patterns

Configuration & Discovery

  • Get caption presets: GET https://public.reap.video/api/v1/automation/get-all-presets

    • Retrieve available caption styles (system, custom, studio)
    • Validate preset IDs before project creation
    • Paginated results with preset metadata

  • Get translation languages: GET https://public.reap.video/api/v1/automation/get-translation-languages

    • List supported language codes for caption translation
    • Validate language codes before creating projects

  • Get dubbing languages: GET https://public.reap.video/api/v1/automation/get-dubbing-languages

    • Retrieve supported language pairs for voice dubbing
    • Identify premium, high, good, and standard quality pairs

Real-time Notifications

  • Webhook integration: Configure webhooks in dashboard at Profile > Settings > Webhooks
    • Receive POST notifications when projects reach final state (completed, invalid, expired)
    • Webhook payload includes projectId, projectType, source, and status
    • Automatic retry with 5-failure auto-disable threshold
    • Supports up to 5 active webhooks per Studio plan
    • Eliminates need for polling in production workflows

Workflows

Complete Video Clipping Workflow

  1. Get upload URL: POST /get-upload-url with filename
  2. Upload video file via PUT to returned presigned URL
  3. Create clipping project: POST /create-clips with uploadId, genre, resolution, orientation, caption preset
  4. Monitor progress: Poll GET /get-project-status every 5-10 seconds or wait for webhook
  5. Retrieve clips: GET /get-project-clips when status is "completed"
  6. Download clips from returned URLs for distribution

Multi-Platform Content Distribution

  1. Upload single landscape video
  2. Create clipping project with reframeClips: true and exportOrientation: portrait
  3. Create separate reframe project with orientation: square
  4. Generate captions with emoji and highlights enabled
  5. Retrieve all variants (landscape clips, portrait clips, square clips with captions)
  6. Distribute to YouTube, TikTok, Instagram, and other platforms

Global Content Localization

  1. Upload original English video
  2. Create caption project with language: "en" and translationLanguage: "es"
  3. Create dubbing project with sourceLanguage: "en-US" and targetLanguage: "es-MX"
  4. Monitor both projects for completion
  5. Retrieve Spanish-captioned and Spanish-dubbed versions
  6. Repeat dubbing for additional target languages (fr-FR, de-DE, etc.)

Batch Processing Multiple Videos

  1. Iterate through array of video files
  2. For each file: Get upload URL, upload video, create project
  3. Store project IDs in database
  4. Set up single webhook endpoint to receive all completion notifications
  5. When webhook fires, fetch clips and trigger downstream processing
  6. Implement idempotent handler to handle potential duplicate notifications

Automated Content Pipeline

  1. Configure webhook at https://yourapp.com/webhook/reap
  2. Create projects via API (clips, captions, reframe, dubbing)
  3. Reap sends POST to webhook when processing completes
  4. Webhook handler immediately returns HTTP 200 with empty body
  5. Asynchronously fetch project details and clips
  6. Trigger downstream tasks (transcoding, publishing, analytics)
  7. Dashboard shows webhook delivery history for monitoring

Integration

Reap integrates with content management systems, video hosting platforms, social media automation tools, and learning management systems. The API uses standard REST with JSON payloads and Bearer token authentication. All endpoints support CORS for browser-based applications. Webhooks enable event-driven architectures, eliminating polling overhead. The API is rate-limited to 10 requests per minute per API key. Plan limits determine concurrent project capacity (Creator: 5, Studio: 15) and maximum export resolution (Creator: 1080p, Studio: 4K).

Context

Authentication: All requests require Authorization: Bearer YOUR_API_KEY header. Generate API keys from dashboard at Profile > Settings > API Keys. Keys can have custom expiration dates or be non-expiring.

Rate Limiting: 10 requests per minute per API key. Response headers include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. Exceeding limits returns 429 status.

Video Requirements:

  • Clipping: 2 min - 3 hours, MP4/MOV, max 5 GB
  • Captions: 3 sec - 15 min, MP4/MOV, clear audio
  • Reframe: 3 sec - 15 min, MP4/MOV, landscape source
  • Dubbing: 3 sec - 15 min, MP4/MOV, clear speech

Project Types: clipping (short clip generation), captions (subtitle generation), reframe (aspect ratio conversion), dubbing (voice localization)

Processing Times: Clipping 5-15 min, Captions 2-5 min, Reframe 3-8 min, Dubbing 10-20 min (varies by video length and complexity)

Video Sources: user_upload (uploaded files), youtube (YouTube URLs), external (direct URLs)

Genres: talking, educational, entertainment, business (used for AI analysis optimization)

Error Handling: Implement exponential backoff for polling. Use webhooks as primary notification method. Handle 401 (auth), 404 (not found), 422 (invalid video), 429 (rate limit) errors gracefully. Webhook endpoints must respond within 10 seconds with HTTP 200 and empty body.

Best Practices: Store API keys in environment variables. Use separate keys for dev/staging/production. Validate language codes and preset IDs before project creation. Design webhook handlers to be idempotent. Monitor webhook delivery history in dashboard. Use webhooks instead of polling for production workflows. Implement proper error handling and retry logic for failed projects.

For additional documentation and navigation, see: https://docs.reap.video/llms.txt

Weekly Installs
3
Source
docs.reap.video
First Seen
4 days ago
Installed on
amp3
cline3
opencode3
cursor3
kimi-cli3
codex3