Set the trailer's capture depth.
Sets the depth preset every capture beat without its own plays at: { preset } — flat, subtle, cinematic, showcase, hero, or none (null) to play them full frame. A beat's own preset is the beat refine's depthPreset and wins. A capture beat's depth plays its recording as a floating window on a branded stage instead of full frame: flat, subtle, cinematic, showcase, hero, shallowest first. Above flat the camera finds the result — it punches in (at most 2× the recording's own pixels) on what each click changed, arriving as it changes, pushes in slowly while the viewer reads, never moves during a scroll and never crops the cursor — and cinematic, showcase and hero add a frame and a 3D turn (cinematic on the opening; showcase and hero hold it through the wide shots, square again before every punch-in), its move varied beat to beat — the left or right side turned away, the top or bottom edge tipped away, a slow push, or held square for about a quarter to a third of the beats. Where the words are read, a held turn is kept strong and made readable: it holds at most of its angle, keeps the words read in focus while the far side falls softly out of focus, and eases only as far as their measured size needs. Showcase sets the recording close up in a laptop or phone on a drifting brand background, and a punch-in never crops the device out of the picture. Each depth beat is rendered beside a flat version and checked: one that got harder to read (smaller text, a softer text crop, words out of focus, or a camera that moves too fast) is first framed closer on its words, keeping its preset and its turn — closer up, the camera pushed in on them, and never a word cut at the frame's edge — and only steps down one preset when that still reads worse, each time rendered again at no charge and keeping the look it asked for (its frame, background and cursor). When the full version cannot be rendered, a quicker version plays instead: subtle, at 720p. Set it for the whole trailer, or per beat; a beat's own preset wins, and none plays the recording full frame as recorded. Free. Free and allowed in any state. On a rendered trailer whose capture beats now play differently the master is built again (masterRebuild: reassembling in review, restitching when finished). Turn angles are refused (409 trailer_capture_turn_angles_not_yet) until the production app reads them. Requires Idempotency-Key. Scope: story:write.
Request
- Base URL: https://docs.sleeperhit.studio/api/v1
- URL: https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/capture-depth
- Auth: HTTP bearer
Headers
Customer-generated stable identifier for safe retries of idempotent POST requests.
Request body
Response
The trailer's capture depth now.
Changes
No recorded changes to this operation across all 1 revision of this API.