Submit SpiderVideo Job

POST/api/v1/jobs/spiderVideo/submit

Overview

SpiderVideo stitches multiple video scenes into a single video with fade transitions, background music, and optional upload to SpiderMedia.

info

Perfect For:

• AI-generated video content (R51 Creative Cloner workflow)
• Multi-scene video assembly from external sources
• Adding background music to video sequences
• Creating professional video content from AI-generated clips

Request Body

payloadobjectrequired

Job configuration payload

properties

projectNamestringrequired

Output filename (without extension). Maximum 200 characters.

aspectRatiostringdefault: 9:16

Video aspect ratio: "9:16" (portrait) or "16:9" (landscape)

scenesarrayrequired

Array of video scenes to stitch together. Maximum 50 scenes.

scene properties

videoUrlstringrequired

URL to the video file. Supports MP4, WebM, and MOV formats.

durationInSecondsnumberrequired

Duration of this scene in seconds. Maximum 300 seconds per scene.

transitionDurationInFramesintegerdefault: 15

Fade transition duration in frames at 30fps. Set to 0 for hard cuts, 15 for half-second fade (default), 30 for one-second fade, max 60.

musicUrlstring

Background music URL. Supports MP3 and WAV formats.

musicVolumenumberdefault: 0.3

Music volume from 0 to 1. Default is 0.3 for subtle background.

preprocessobject

Preprocessing options for video compatibility.

preprocess properties

enabledbooleandefault: false

Auto-fix invalid video formats with FFmpeg.

uploadobject

Upload options for rendered video.

upload properties

enabledbooleandefault: false

Upload rendered video to SpiderMedia.

testbooleandefault: false

Route job to test queue for development.

priorityintegerdefault: 5

Job priority from 0 to 10. Higher values are processed first.

Example Request

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://example.com/scene1.mp4", "durationInSeconds": 5},
        {"videoUrl": "https://example.com/scene2.mp4", "durationInSeconds": 3}
      ],
      "upload": {"enabled": true}
    }
  }'

Example with Music

{
  "payload": {
    "projectName": "promo-video",
    "aspectRatio": "9:16",
    "scenes": [
      {"videoUrl": "https://cdn.example.com/intro.mp4", "durationInSeconds": 3},
      {"videoUrl": "https://cdn.example.com/main.mp4", "durationInSeconds": 10}
    ],
    "transitionDurationInFrames": 15,
    "musicUrl": "https://cdn.example.com/background.mp3",
    "musicVolume": 0.3,
    "upload": {"enabled": true}
  }
}

Response

job_idstring

Unique job identifier for status polling.

statusstring

Initial status is "queued".

messagestring

Confirmation message with scene count.

Result Data

When the job completes, poll the results endpoint to get:

{
  "success": true,
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "type": "spiderVideo",
  "status": "completed",
  "data": {
    "success": true,
    "outputFile": "/tmp/render-abc123/my-video.mp4",
    "fileSize": 15728640,
    "renderTime": 45.2,
    "format": "mp4",
    "resolution": "1080x1920",
    "uploadedUrl": "https://media.spideriq.ai/client-bucket/videos/my-video.mp4"
  }
}

note

Processing time depends on video complexity. Expect one to three minutes for up to five scenes, three to eight minutes for up to fifteen scenes, and eight to twenty minutes for larger jobs.

Queue Limits

• Production Queue: 500 jobs maximum
• Test Queue: 100 jobs maximum
• Max Render Time: 30 minutes per job

warning

SpiderVideo workers are CPU-intensive. The queue is smaller than other worker types to prevent overload.