Concatenate Videos

Join multiple video files end-to-end into a single output file.

When to use

• Merge clips — combine multiple segments into one continuous video.
• Stitch recordings — join separate recordings from the same session.
• Assemble a reel — combine trimmed clips after video.trim.

Inputs & outputs

Input modality	Multiple video files (URLs array)
Output modality	Video file (GCS URL)
Min inputs	2 videos
Max inputs	10 videos

Parameters

No parameters required. Clips are joined in the order provided in the videos array.

Param	Required	Description
(none)	—	Pass an empty object {}

Examples

Join two clips

{
  "type": "video.concat",
  "input": { "videos": ["gs://infery-prod-media/clip1.mp4", "gs://infery-prod-media/clip2.mp4"] },
  "params": {}
}

Assemble a three-part video

{
  "type": "video.concat",
  "input": {
    "videos": [
      "gs://infery-prod-media/intro.mp4",
      "gs://infery-prod-media/main.mp4",
      "gs://infery-prod-media/outro.mp4"
    ]
  },
  "params": {}
}

Related capabilities

• video.trim — cut clips to size before joining
• video.transcode — normalize all clips to the same codec before concatenating
• video.pipeline — chain trim + concat + transcode in one step

{}