Set, reset or quote a capture beat's screen look.
Changed onSets the beat's own preset and tuning ({ preset, overrides }, the tuning replacing what it holds), or returns it to the trailer's look exactly ({ reset: true }); dryRun: true only quotes. overrides.tilt.startDeg with tilt.endDeg set the turn's angle in degrees at the beat's first and last frame (0–28, a yaw at most 25.2°), eased between; tilt.angleScale: 0 turns 3D depth off; camera.maxScale is the punch-in. A turn under about 10° leaves an edge of the screen almost level, which reads as a crooked crop rather than depth, so it is nudged to the nearest clean angle — or to square — and the preview says so. Free: quote.beatsRepictured names the beats whose picture the change re-renders (a new camera move also varies its neighbours). Turn angles are refused (409 trailer_capture_turn_angles_not_yet) until the production app reads them. On a rendered trailer the master is built again (masterRebuild). Requires Idempotency-Key. Scope: story:write.
Request
- Base URL: https://docs.sleeperhit.studio/api/v1
- URL: https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/beats/{beatIndex}/capture-look
- Auth: HTTP bearer
Headers
Customer-generated stable identifier for safe retries of idempotent POST requests.
Request body
Response
The beat's screen look now, and the quote.
Changes
- warning
added the new
screenenum value to the/////response property for the response status - warning
added the new
screenenum value to the/////response property for the response status - warning
added the new
screenenum value to the/////response property for the response status - warning
added the new
screenenum value to the//////////response property for the response status - warning
added the new
screenenum value to the/////response property for the response status - info
added the new
screenenum value to the request property
- warning