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.
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
Customer-generated stable identifier for safe retries of idempotent POST requests.
Request body
Response
The deck's title sequence, as saved.
Changes
No recorded changes to this operation across all 1 revision of this API.