Read the pitch deck's score to picture.
The score composed to the pitch deck's cut and whether one can be composed now: status (none, waiting_for_master, queued, composing, laid, failed, reverted), canScore and blocked (why not — music the writer placed is never replaced), runtimeMs, fitsCut (false when the cut changed after the score was composed: it still plays, off the cuts) and the cueSheet: its concept and palette, its sections by cut number with their windows in ms, mood, instrumentation and intensity, its hit points (the cuts the music lands on), its intensity curve and where speech sits; and silentGap (null unless it happened): the laid score fell silent when it was first composed (under −50 dBFS for longer than 1.5 s, the ending's fade-out aside), so it was composed again — or what stayed silent was filled from the music beside it — with where (found, ms of the master), the cue-sheet sections, the action (recomposed / filled) and the writer's note, which also ends message. A score with dead air is never laid. Before any master, plannedCut is true (runtimeMs and cuts are the planned cut, every unit at its planned length) and sketch is the sketch composed to it for a score that waits for the master: status (composing, ready, failed), url to listen to, composedAt, fitsCut (false when the plan changed since) and error — never laid, never charged; null once the score is on its way to the real cut. On a deck whose title sequence cuts on the bell's beat grid, the cueSheet carries beatGrid (the beat, the tempo, and the required bell strikes: every intro cut and the title, with hit points marked required), and beatAlignment (null otherwise) is the score check: each strike's cut, the nearest bell onset measured in the laid score, the offset in ms and in frames and whether it is within a frame (aligned), the constant shiftMs applied to put them on the cuts (a shift, never a retime), and the note — a warning ("Intro bell strikes not on the cuts: …") when they are not, which also ends message. Nothing is composed again for it: scoring again is the writer's priced choice. When status is failed, error is why (the Details). A score asked for with a direction that could not be composed is NEVER replaced by the table read's scene beds: they come off the cut, the bell lane and the sound effects stay, and message says so plainly — "The score couldn't be composed (reason in Details). The bell plays alone. Score to picture to try again." (with no bell lane, no music plays under the cut; music the writer placed is named as still on it). Say that to the writer. Scoring to picture again without a new direction keeps the one it had; a score asked for without a direction that fails still leaves the scene beds. Scope: story:read.
Request
- Base URL: https://docs.sleeperhit.studio/api/v1
- URL: https://docs.sleeperhit.studio/api/v1/pitch-decks/{jobId}/score-to-picture
- Auth: HTTP bearer
Response
The score's state and its cue sheet.
Changes
No recorded changes to this operation across all 2 revisions of this API.