Sume video filter limits: 8 ops, then a 2048-character filtergraph
Sume video filter takes up to 8 dim or crop ops, then an optional filtergraph of up to 2048 characters and 32 filters. Source clips are capped at 300 seconds.
Sume video filter accepts at most 8 ops[] entries (dim or crop) and an optional filters-only filtergraph of at most 2048 characters and 32 named filters, applied after the ops. Anything else is refused with a stable code, and the source clip must be 300 seconds or shorter. The numbers are from Video filter, read 2026-10-06.
What are the limits?
Limits and the code you see when you cross them:
| Limit | Value | Code |
|---|---|---|
| Ops per request | 8 | video_filter_too_many_ops |
| Op kinds | dim, crop | unsupported_filter_op |
| Filtergraph size | 2048 characters, 32 filters | invalid_filtergraph |
| Source length | 300 s | output_duration_exceeded |
| Price | $0.02 per encode job; the check is free | See GET /v1/catalog |
What can the filtergraph not contain?
The graph has no inputs, no outputs and no paths, and it cannot use stream specifiers such as [0:v]; the server wraps it itself. trim and setpts are not on the allowlist (use video trim), nor are drawtext, subtitles, movie and lut3d, nor any filter that reads a file or a socket. Client fields such as vf, filter, ffmpeg, cmd, codec and crf return ffmpeg_fields_rejected.
How do I avoid paying for a bad program?
Call POST /v1/video-filter/check first. It runs the same schema, allowlist and source checks as the encode, returns valid, diagnostics[] and a compiled program.filters list, and creates no job and reserves nothing. A valid program can still fail on the box (memory, time, a bad expression), and then you get a structured job error.
Sources
Related posts
More in Media tools
- Video frames fps on Sume: mid-bin sampling and the 24-frame cap
Sume video frames with fps 0.5 samples at 1 s, 3 s, 5 s and so on, capped at 24 frames per call, at source size. Use at[] for exact instants.
- Video inspect on Sume: 8 stills at 768 px and the fast seek option
Sume video inspect returns 8 mid-bin stills at a 768 px long edge by default, up to 24 stills, and a fast seek mode that can land one GOP early.
- AI video upscaler API fields: factor 1.1 to 4 and fast, standard, pro
The Sume Video Upscale request takes upscale_factor from 1.1 to 4, duration_seconds from 1 to 30 and an enhancement_tier. What they do and cost.
- Voiceover longer than your clips: Timeline pads, loops, 0.5 s rule
If the voiceover outruns your clips, Sume Timeline still renders to audio.duration_seconds: short sources pad or loop, and coverage may stop 0.5 s early.
Written by Sume