Multi-op Video Pipeline

Chain up to 10 video operations in a single request. The operations are applied sequentially to the same video input.

When to use

• Reduce latency and cost — avoid uploading/downloading intermediate files between steps.
• Complex workflows — trim → scale → watermark → transcode in one call.
• Atomic processing — all steps succeed or none persist output.

Inputs & outputs

Input modality	Video file (URL)
Output modality	Video file (GCS URL)
Max operations	10
Max input duration	30 min

Parameters

Param	Required	Description
operations	yes	Array of 1–10 operation objects. Each is { "<op>": { ...params } }.

Supported operation keys: trim, scale, crop, watermark, transcode, extractFrame, audioExtract, concat.

Examples

Trim, scale, and transcode in one step

{
  "type": "video.pipeline",
  "input": { "video_url": "gs://infery-prod-media/example/raw.mov" },
  "params": {
    "operations": [
      { "trim": { "start": 0, "end": 60 } },
      { "scale": { "width": 1280 } },
      { "transcode": { "format": "mp4", "codec": "h264", "bitrate": "2M" } }
    ]
  }
}

Crop, watermark, and re-encode

{
  "type": "video.pipeline",
  "input": { "video_url": "gs://infery-prod-media/example/input.mp4" },
  "params": {
    "operations": [
      { "crop": { "x": 0, "y": 0, "width": 1280, "height": 720 } },
      { "watermark": { "watermark_url": "gs://infery-prod-media/brand/logo.png", "position": "br" } },
      { "transcode": { "format": "mp4", "codec": "h264" } }
    ]
  }
}

Related capabilities

• video.transcode — single-op re-encoding
• video.trim — single-op clip extraction
• video.watermark — single-op overlay

{
  "operations": [
    {
      "trim": {
        "start": 0,
        "end": 30
      }
    },
    {
      "scale": {
        "width": 1280
      }
    },
    {
      "transcode": {
        "format": "mp4",
        "codec": "h264"
      }
    }
  ]
}