Video APIv1 Home OpenAPI spec

Docs › Processing options

Processing options

Send these in the body of complete (and of reprocess). maxHeight is set on create.

OptionTypeDescription
maxHeight720 | 1080 | 1440 | 2160Highest quality produced; default 1080. Every lower level is made too. Never upscales; higher takes longer.
trim{start, end}Keep only this part, in seconds into the upload. Frame-accurate; costs no extra processing time.
redactionsarray (≤ 20)Regions to blur or black out, each during a time window. See below.
deleteOriginalbooleanDelete your uploaded original once the result is published. Use it with redactions when the unredacted file must not be kept. The video can't be reprocessed afterwards.
captionstrue | {"language": "es"}Pro and Scale: subtitles made from the speech. See Captions.
POST /videos/3f1c…/complete
{
  "trim": { "start": 4.5, "end": 312 },
  "redactions": [
    { "type": "box",  "x": 0.05, "y": 0.04, "w": 0.30, "h": 0.06, "start": 0, "end": null },
    { "type": "blur", "shape": "ellipse", "x": 0.62, "y": 0.55, "w": 0.20, "h": 0.30, "start": 12.5, "end": 20 }
  ]
}