Burn a rule-of-thirds grid onto a video for review with drawgrid
Sume's video filter allowlists drawgrid. Set width and height to iw/3 and ih/3 for a thirds grid. The grid is burned in, so it is a proof file.

For a framing review, drawgrid draws a grid over the whole clip. It is in Video filter under Compositing, and width and height take expressions, so iw/3 and ih/3 give a rule-of-thirds grid at any resolution. The grid is burned into the new MP4, so treat the result as a review proof and keep the clean original for delivery.
Which drawgrid options draw the grid?
| Option | What it does |
|---|---|
width / w, height / h | Grid cell size; defaults to 0. Use iw/3 and ih/3 for thirds. |
color / c | Line color, default black. white@0.5 sets half opacity. |
thickness / t | Line width, default 1. |
x, y | Offset of the grid from the top-left, default 0. |
How do I get a visible, not-too-loud grid?
Use white lines at half opacity with a thickness of 2 so they show on dark and light footage. Because the grid cell is the frame width over three, lines fall at one third and two thirds across, plus one on the frame edge at offset 0. Run the free check, then encode.
curl -X POST https://api.sume.com/v1/video-filter/check \
-H "Authorization: Bearer $SUME_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"video_url": "https://media.sume.com/artifacts/artf_demo/framing.mp4",
"filtergraph": "drawgrid=w=iw/3:h=ih/3:t=2:c=white@0.5"
}'Can I mark one subject instead of the whole frame?
Use drawbox for a single rectangle; see draw a box on a video frame. The two filters combine in one graph, so a grid and a highlighted target can ship in the same proof.
What about a safe-zone overlay for Reels or Shorts?
A thirds grid is a composition aid, not a platform safe-zone guide. For safe margins, a drawbox at the fractions you need works, but check the platform's own spec for the numbers; Sume's docs do not publish per-platform safe areas.
What does a filter job cost and where are the limits?
The docs list $0.02 per encode job, with a source of at most 300 seconds, a filtergraph of at most 2048 characters and 32 named filters. The /v1/video-filter/check route runs the same allowlist and source checks for free and returns valid and next_action; a graph that passes can still fail on the worker (bad expression, memory, time), which comes back as a structured job error.
Sources
Related posts
More in Developers
- gen3a_turbo no longer available on Runway: re-read Sume's model list
Runway now fails requests for gen3a_turbo and gen4_aleph. Avoid the same break on Sume: read /v1/videos/models instead of hard-coding ids.
- Runway Model Router allow and deny lists vs Sume auto
Runway's Model Router has allow and deny lists plus per-modality credit ceilings. Sume has no lists: pin a catalog id, or send sume/auto and accept its pick.
- Runway per-generation usage export vs the Sume GET /v1/usage ledger
Runway's enterprise usage export lists credits per generation. On Sume, GET /v1/usage returns USD ledger rows per workspace, filterable by job_id.
- Seedance 2.5 1080p ratio 1920:1080 on Sume: resolution + aspect_ratio
Runway takes a 1080p ratio like 1920:1080. Sume takes two fields instead: resolution 1080p plus aspect_ratio 16:9, and rejects size on v1.
Written by Sume