Trailer

Cut one of a beat's lines out of its footage and keep the rest (free).

NOT metered and NOT confirmed: FREE, one call. Cut the line, keep the rest (free, one step): one of the beat's spoken lines leaves its plan (its words and who says it), and each take that says it is trimmed to the footage on one side of it — after the line when the line opens the take, before it when it closes it — measured where the take says it, with a small pad, so nothing of the line is heard. The trimmed take is the same footage, so the beat stays current: nothing is rendered or charged, the trimmed take plays as soon as it lands, and its sound is the take's own sound with the line cut out. A beat with several lines names the one to cut (line, from 1, as its lineDrops list them). A line with footage on both sides is refused until you choose keep before or keep after; so is a side shorter than 1.5 s. Name a beat to move the line to and its words and speaker go there, to be rendered with that beat's own staging; otherwise add it there with a refine. The beats read's lineDrops says, line by line, what it would do now (the takes it trims and the span each keeps) or why it cannot; droppedLines shows the lines already cut out and each trim's state. Calling it again (without line) on a beat whose line was already cut out queues again only the trims that never landed (resumed). Refused before anything changes (409, details.refusal.code): drop_line_which_line (name line), drop_line_in_middle (choose keep), drop_line_too_short, drop_line_cuts_other_line, drop_line_not_rendered, drop_line_no_take, drop_line_unplaced, drop_line_no_line, drop_line_target_has_line. A complete trailer goes back to review. Review or complete only. Requires Idempotency-Key. Scope: story:write.

post/trailers/{jobId}/beats/{beatIndex}/drop-line

Request

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

Headers

Idempotency-Keystring required

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

Request body

lineinteger

Which of the beat's lines (from 1, as its lineDrops list them). Omit it when the beat says one line.

keep'before' | 'after'

Which side of the line each take keeps. Omit it to keep the side with footage; a line with footage on both sides needs it (drop_line_in_middle).

toBeatIndexinteger

The beat the line's words and speaker move into, as its own line. Refused when it already has another. Omit to only cut the line out.

Response

The line, cut out: each take's trim queued as a new take.

jobIdstring required
beatIndexinteger required
beatNumberinteger required
queuedboolean required
resumedboolean required

The line was cut out before; only its trims that never landed were queued again.

currentboolean required

Whether the beat's takes are current now (false: it was already out of date for another change).

messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.