Pitch Deck

Strike a bell on every beat of the pitch deck.

Strike ONE bell sound on every beat of the deck's bell beat grid, frame-exact, as one lane on its audio timeline — or change the lane. The sound is assetId (a My Library sound effect), sound: { fromJobId } (another deck's bell of the same project, exactly as it struck there: the same bell as v2), or prompt (words for one to be made with the sound-effect generator and banked in My Library; label, durationSeconds), or — on a change — the lane's own. every 1 (every beat, default) or 2 (every 2nd beat); fromSeconds/toSeconds in seconds of the master (null: its first/last frame, the default); skipSceneIndexes the parts it stays out of (black interludes, chapters, the title sequence); accent (the intros and the title louder, default true); level 0–1 (0.12: every bell is struck levelled to a -1 dBFS peak, and 0.12 sits a few dB under a laid score); duckUnderVoice (default true: it ducks under the spoken lines like the score). Fields left out keep the lane's; an unknown field is refused by name. Free: nothing is rendered again — a deck in review or finished re-stitches its master for its sound (reassembling), a sketch waiting for its master is mixed again with the bell (sketchRemixing), and a score to picture composed with a lane leaves room for the struck bell (no bell of its own, nothing on the downbeat). Refused with a 409 when the deck has no bell beat grid. Requires Idempotency-Key. Scope: story:write.

post/pitch-decks/{jobId}/bell-lane

Request

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

Headers

Idempotency-Keystring required

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

Request body

assetIdstring

A My Library sound effect to strike.

promptstring

Or words for the bell to be made from (one sound effect, banked in My Library).

labelstring

The made bell's name.

durationSecondsnumber

The made bell's length in seconds (5 when left out).

every1 | 2

1: every beat (default). 2: every 2nd beat.

fromSecondsnumber nullable

Where it starts, in seconds of the master; null for its first frame.

toSecondsnumber nullable

Where it stops (inclusive), in seconds of the master; null for its last frame.

skipSceneIndexesnumber[]

The parts it stays out of, by the sceneIndex the read lists in parts.

accentboolean

Accent the strike on each intro and on the title (default true).

levelnumber

Level 0..1 (0.12 by default) on a bell levelled to a -1 dBFS peak.

duckUnderVoiceboolean

Duck under the spoken lines like the score (default true).

Response

The bell lane as set, and whether the master is re-stitched and the sketch mixed again.

object required

Changes

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