​
Overview

SpiderVideo uses Remotion to render professional video content by stitching together multiple video scenes with fade transitions and background music.
SpiderVideo was built for the R51 Creative Cloner workflow, which generates AI video scenes using Runway ML. SpiderVideo then stitches these scenes into final videos ready for social media.

​
Quick Start

1

Prepare Video Scenes

Upload your video scenes to accessible URLs. Supported sources include Airtable attachment URLs, S3 or R2 presigned URLs, any publicly accessible video URL, and SpiderMedia URLs from other jobs.Supported formats: MP4, WebM, MOV
2

Submit Stitching Job

curl -X POST "https://spideriq.ai/api/v1/jobs/spiderVideo/submit" \
  -H "Authorization: Bearer $AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {
      "projectName": "my-video",
      "scenes": [
        {"videoUrl": "https://cdn.example.com/scene1.mp4", "durationInSeconds": 5},
        {"videoUrl": "https://cdn.example.com/scene2.mp4", "durationInSeconds": 3}
      ],
      "upload": {"enabled": true}
    }
  }'
3

Poll for Results

Check job status until completed:
curl "https://spideriq.ai/api/v1/jobs/{job_id}/results" \
  -H "Authorization: Bearer $AUTH_TOKEN"
4

Get Rendered Video

When status is “completed”, the uploadedUrl contains your final video.

​
Configuration Options

​
Aspect Ratio

Choose the right aspect ratio for your platform:
  • 9:16 (default) - Portrait for TikTok, Instagram Reels, YouTube Shorts (1080x1920)
  • 16:9 - Landscape for YouTube, Vimeo, LinkedIn (1920x1080)

​
Transitions

Control fade transitions between scenes using transitionDurationInFrames at 30fps:
  • 0 - No transition (hard cut)
  • 15 - Half second fade (default)
  • 30 - One second fade
  • 60 - Two second fade (maximum)

​
Background Music

Add ambient music that plays throughout the entire video: 
{
  "payload": {
    "musicUrl": "https://cdn.example.com/music.mp3",
    "musicVolume": 0.3,
    "scenes": []
  }
}
Supported formats: MP3, WAV Volume tips:
  • 0.2 to 0.3 for subtle background (recommended for talking-head videos)
  • 0.5 to 0.7 for balanced (good for montages)
  • 0.8 to 1.0 for prominent (when music is the focus)

​
Preprocessing

Enable FFmpeg auto-fix for videos with compatibility issues: 
{
  "payload": {
    "preprocess": {"enabled": true},
    "scenes": []
  }
}
Preprocessing adds time to the render. Only enable it if you experience format errors.

​
SpiderMedia Upload

Upload the rendered video to your SpiderMedia bucket: 
{
  "payload": {
    "upload": {"enabled": true},
    "scenes": []
  }
}

​
Best Practices

Recommended: MP4 with H.264 codec, 30fps frame rate, 1080p resolution, AAC audio codec. If using other formats, enable preprocessing.
Keep individual scenes under 5 minutes for optimal processing. Total video length should be under 10 minutes for reliable rendering.
Maximum 50 scenes per job. For videos with more scenes, split into multiple jobs. Each additional scene adds 10 to 20 seconds to render time.
Use direct video URLs without redirects. Ensure videos are publicly accessible. Pre-transcode to H.264 MP4 for fastest rendering. Use CDN URLs for faster asset download.

​
Troubleshooting

Cause: The URL returns HTML instead of video data. Solution: Test the URL in a browser. Check for auth requirements. Use direct video URLs, not embed URLs.
Cause: Video codec not supported by Remotion. Solution: Enable preprocessing or convert to H.264 MP4 before submitting.
Cause: Video too long or too many scenes for the 30-minute limit. Solution: Reduce total scene count. Reduce individual scene durations. Split into multiple jobs.

​
Next Steps

API Reference

Full API documentation with all parameters

Media Storage

Learn about SpiderMedia integration