Trailer

Trim one take of a beat's call to a span (free).

NOT metered and NOT confirmed: FREE, one call. Trims one take to the span [keepStartSeconds, keepEndSeconds) — "trim this take to <start>–<end>" — snapped to the take's frames and kept as a NEW take linked to it (trimTake); the take itself stays. Never into a spoken line: a span that cuts into a line placed on the take's speech track is refused (trim_cuts_speech), as is a span outside the take, shorter than the shortest a take is trimmed to, or the whole take (trim_span_invalid) — each before anything is queued. The trimmed take is checked again and watched, and plays over the take it came from only if it passes; its cut then plays its real, shorter length. The repair engine does the same on its own when a cut nobody asked for sits at the start or end of an otherwise good take (rule trim_edge, measured in the file: a hard cut or the first frame of a dissolve), and when a speaker's lips run on past the take's last line where nothing is heard (rule trim_overrun: cut half a second after the line as the take says it). Each take's trimBounds says what it may keep. Review or complete only. Requires Idempotency-Key. Scope: story:write.

post/trailers/{jobId}/beats/{beatIndex}/trim-take

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/beats/{beatIndex}/trim-take
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Request body

callIdstring required

One of this unit's call ids (from the beats or chapters read).

takeinteger required

The take to trim: an accepted take of the call.

keepStartSecondsnumber required

Where the kept span starts, in seconds of the take (snapped to its frames).

keepEndSecondsnumber required

Where the kept span ends, in seconds of the take; must keep every spoken line whole.

Response

The trim, queued as a new take.

jobIdstring required
callIdstring required
takeinteger required
trimTakeinteger required

The take number the trim is recorded as.

keepStartSecondsnumber required
keepEndSecondsnumber required
queuedboolean required
messagestring required

Changes

No recorded changes to this operation across all 2 revisions of this API.