Video inspect hdr flag: spot PQ or HLG clips before you submit
Sume video inspect returns probe.hdr, color_transfer and pix_fmt. Read them first and route HDR clips away from the video filter and exact trim.
Sume video inspect returns a probe object, and two of its fields tell you whether a clip is HDR: color_transfer (the raw tag, such as smpte2084 or arib-std-b67) and hdr, a boolean that is true for exactly those PQ and HLG transfers. The API reference describes hdr as the early signal for sources the video filter refuses with hdr_source_unsupported, so a program is never submitted against them.
With frames: false the call returns only the probe, no stills and no transcript, so it is the cheapest look at a file. Sync is the default mode, and the handler waits up to 30 seconds before it returns 202 and lets you poll.
Fields worth reading together
| Field | What it tells you |
|---|---|
| hdr | True for PQ or HLG transfers |
| color_transfer | The raw transfer tag, or null |
| pix_fmt | Pixel format, for example a yuv or an RGB family |
| rotation | Degrees the player rotates the frame |
| is_still | True when the file is an image, not a video |
A routing rule
Branch on the probe once, then pick the tool.
hdrtrue: trim withprecision: "keyframe"or export an SDR copy first.is_stilltrue: a trim or filter will refuse it as not a video.pix_fmtoutside the yuv family: the filter returnsunsupported_pixel_format.
Request
The probe call needs Idempotency-Key and a media.sume.com URL the workspace already owns.
curl -X POST https://api.sume.com/v1/video-inspect \
-H "Authorization: Bearer $SUME_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: probe-001" \
-d '{"video_url": "https://media.sume.com/artifacts/artf_demo/clip.mp4", "frames": false}'Read probe.hdr from the result and stop there if it is true. One cheap probe saves a failed filter job and a retry.
Sources
Related posts
More in Media tools
- video_inspect is not free: a $0.0899 Modal hold, then actual seconds
video_inspect now holds a $0.0899 Modal ceiling and captures its own container seconds at Modal list x 1.25 plus the 5.5% fee. Transcripts add $0.01 a minute.
- Video inspect 400 video_inspect_transcribe_required: the fix
Sending language_code, segmentation or duration_seconds to Sume video inspect without transcribe true returns a 400. Why, and the request that works.
- Video trim limits on Sume: 1800 s source, 900 s output, error codes
Video trim takes a source up to 1800 seconds and cuts at most 900 seconds, at least 0.2. Here are the limits, the clamp warning and the stable error codes.
- Which field holds the file URL in a Sume media job result
Sume media jobs return different result keys: audio_url for detach, video_url for trim and filter, frames for stills. A field map for no-code steps.
Written by Sume