Pitch Deck

Cut a chapter's line 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): the chapter's spoken line leaves its plan (its words, its voice and how it is said), 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 chapter 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 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, and a trim that would leave another chapter of its scene group with no shot. Name a chapter to move the line to and its words, speaker and delivery go there, to be rendered with that chapter's own staging; otherwise add it there with a refine. The chapters read's lineDrop says what it would do now (the takes it trims and the span each keeps) or why it cannot; droppedLine shows a line already cut out and each trim's state. Calling it again on a chapter 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_in_middle (choose keep), drop_line_too_short, drop_line_empties_chapter, drop_line_cuts_other_line, drop_line_narrated, drop_line_not_rendered, drop_line_no_take, drop_line_unplaced, drop_line_target_has_line. A complete deck goes back to review. Review or complete only. Requires Idempotency-Key. Scope: story:write.

post/pitch-decks/{jobId}/chapters/{chapterIndex}/drop-line

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/pitch-decks/{jobId}/chapters/{chapterIndex}/drop-line
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Request body

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

toChapterIndexinteger

The chapter (its key from the chapters read) the line's words, speaker and delivery move into. Refused when it already has another line. Omit to only cut the line out.

Response

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

jobIdstring required
chapterIndexinteger required
chapterNumberinteger required
queuedboolean required
resumedboolean required

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

currentboolean required

Whether the chapter'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 2 revisions of this API.