Pitch Deck

Set the deck's title sequence.

Sets the deck's title sequence whole (null removes it; the chapters read returns the current one as titleSequence, with what each flash cut goes to and each person's name super, supers). A deck's title sequence opens its master, before the first chapter: optionally an epigraph (epigraph: its words and where they are from) and a source credit (sourceCredit), each quiet on black and held long enough to read; then flash cuts of six to ten frames to the people it names (cast, in order; inShadow darkens one), each the person's LIVING PORTRAIT — looking into the lens, still, breathing, rendered for the flash (priced first, its own step) — and until it is made a still, silent close from the deck's own takes or another rendered deck of the project (free), never one in which anyone speaks or moves; a still canon portrait image only when the writer asks for one (flashSource: 'portrait'); then the title (title, one word, in capitals) in a bold sans on black. The flash cuts and the title run seconds (3 to 5). With nameSupers: true each flash cut carries the person's NAME in the TITLE'S LOOK — the face and colour the title is drawn in (blood red, the heavy condensed sans, when the title is directed so), uppercase, large enough to read at 480p — on the bell beat with the face, set in the black BESIDE the picture (or over the top of it), never over the face: LABEL is the first word of the person's canon name in capitals unless their cast entry sets label, and role (up to 40 characters, optional) is a smaller line under it; a person inShadow gets no name unless their label is set (the shadow withholds who they are); how the names look and where they sit is directed with titleElement: nameSupers. With beatGrid: true the intros cut on the bell's beat: from the sequence's first frame a beat every beatSeconds (0.5 to 4; 2 when left out), each flash cut starting on a beat and holding exactly one beat (the one in shadow too), the title on the next beat for titleBeats beats (1 to 8; 2 when left out) — their seconds are then derived (beats × beatSeconds), and a score composed to the deck strikes its bell on every intro and on the title. Saving it is free: nothing is rendered for it (a motion close is its own priced step). enabled: false keeps it without playing it. How its words look and move is directed separately (titleElement on the direct-text-motion call; read back as textMotion), and a save keeps those directions. Validated whole: a one-word title, nobody named twice, and everyone in the cast canon when the project has one (400 otherwise). Free. On a draft plan the changed plan is queued for plan coverage again (planCoverage: the story judge reads the title); in review or complete the master is re-assembled with it (reassembling). Refused while a render or finish pass runs (409). Requires Idempotency-Key. Scope: story:write.

post/pitch-decks/{jobId}/title-sequence

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/pitch-decks/{jobId}/title-sequence
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Request body

Response

The deck's title sequence, as saved.

successtrue required
jobIdstring required
reassemblingboolean required

True when the master is re-assembled for the change (a deck in review or complete; free).

planCoverage'queued' | 'current' | 'failed' | 'null' nullable required

On a draft: the changed plan's coverage (queued for the latest edit). Null otherwise.

Changes

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