Price, then compose, a score to the trailer's cut.
Composes ONE score to the trailer's cut — a cue sheet planned over its beats (sections that change on the cuts, an intensity curve, hit points at chosen cuts, room under every spoken line, the Series Bible's tone and period), a composition conformed to the master's length to the frame — and lays it under the whole master in place of the table read's scene beds, then re-stitches the master through its serialized assembly. TWO CALLS, PRICE FIRST: sent WITHOUT confirmed it prices the score and holds nothing (quotedOnly: true, credits, balanceAfter, sufficient, note); sent again with confirmed: true it holds the quoted credits and starts composing. On a DRAFT plan (so the music direction is set before anything renders) or while the first render pass is still running, it is priced on the PLANNED cut and waits for that pass's master (waiting_for_master), and a SKETCH to the planned cut is composed right away by the same planner and composer — free, never laid — to listen to (sketch.url on the read). Priced like the app's other music generation: included today (0 credits), still quoted first. Refused with a 409 before any price when the writer placed music of their own or edited an earlier score (the writer's music is never replaced), or while a score is already composing. direction is an optional note on the music the writer wants. Requires Idempotency-Key. Scope: artifact:publish.
Request
- Base URL: https://docs.sleeperhit.studio/api/v1
- URL: https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/score-to-picture
- Auth: HTTP bearer
Headers
Customer-generated stable identifier for safe retries of idempotent POST requests.
Request body
Response
The price (no confirmed), or the started score. On a trailer with no screenplay whose video a blank beat holds, the started score lands on the timeline and answers masterHold (the video is not stitched again until each blank beat is fixed).
Changes
No recorded changes to this operation across all 3 revisions of this API.