Pitch Deck

Score one scene's music bed.

One endpoint, selected by action: score generates a new bed from a prompt, apply-library reuses a track already in My Library (no generation, and the way several scenes come to share a tempo and key), update relevels or retimes the bed, remove clears it. Beds render with the Lyria engine, so they are never blocked by the fal balance; describe the SOUND rather than naming a real artist. Generating — score, or an update that changes the prompt or vocals — waits for the project's gate: while it is closed the call is refused with 409 project_precondition_failed and no bed is written or queued; apply-library, a level or timing update and remove stay open. Requires Idempotency-Key. Scope: story:write.

post/pitch-decks/{jobId}/storyboard/music

Request

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

Headers

Idempotency-Keystring required

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

Request body

action'score' | 'update' | 'remove' | 'apply-library' required
sceneIndexinteger required

Zero-based index of the scene.

Response

The updated music bed, plus a shareable per-scene preview link.

object required

Changes

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