Trailer

Set, reset or quote a capture beat's screen look.

Changed on

Sets 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.

post/trailers/{jobId}/beats/{beatIndex}/capture-look

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

Idempotency-Keystring required

Customer-generated stable identifier for safe retries of idempotent POST requests.

Request body

preset'screen' | 'flat' | 'subtle' | 'cinematic' | 'showcase' | 'hero' | 'none' nullable

The beat's own preset; none plays it full frame; null follows the trailer's. Omit to leave it.

resetboolean

Back to the trailer's look exactly: the beat's own preset and tuning both cleared.

dryRunboolean

Quote only: say which beats' pictures would change, and save nothing.

Response

The beat's screen look now, and the quote.

jobIdstring required
beatIndexinteger required
beatNumberinteger required
captureIdstring nullable required
sentencestring required
savedboolean required
masterRebuild'reassembling' | 'restitching' nullable required

Changes

    • warning

      added the new screen enum value to the ///// response property for the response status

    • warning

      added the new screen enum value to the ///// response property for the response status

    • warning

      added the new screen enum value to the ///// response property for the response status

    • warning

      added the new screen enum value to the ////////// response property for the response status

    • warning

      added the new screen enum value to the ///// response property for the response status

    • info

      added the new screen enum value to the request property