POST
https://spideriq.ai
/
api
/
v1
/
jobs
/
spiderVideo
/
submit
Submit SpiderVideo Job
curl --request POST \
  --url https://spideriq.ai/api/v1/jobs/spiderVideo/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "payload": {
    "projectName": "<string>",
    "aspectRatio": "<string>",
    "scenes": [
      {
        "videoUrl": "<string>",
        "durationInSeconds": 123
      }
    ],
    "transitionDurationInFrames": 123,
    "musicUrl": "<string>",
    "musicVolume": 123,
    "preprocess": {
      "enabled": true
    },
    "upload": {
      "enabled": true
    },
    "test": true
  },
  "priority": 123
}
'
{
  "job_id": "<string>",
  "status": "<string>",
  "message": "<string>"
}

​
Overview

SpiderVideo stitches multiple video scenes into a single video with fade transitions, background music, and optional upload to SpiderMedia.
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

​
payload
object
required
Job configuration payload
​
priority
integer
default:"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_id
string
Unique job identifier for status polling.
​
status
string
Initial status is “queued”.
​
message
string
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"
  }
}
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
SpiderVideo workers are CPU-intensive. The queue is smaller than other worker types to prevent overload.