Trailer

Switch the cut's audio policy.

Switch the cut between narrate and suppress — sent as { audioPolicy }. A narrated cut speaks each beat's narrationText in ONE voice (the cast narrator), rendered as a separate per-beat track mixed over the finished picture; a suppressed cut is caption-carried. The policy is read once per render stage, so it is refused (409) while a render or finish pass is running. The read is GET /trailers/{jobId}/narrator, which carries audioPolicy. Free to store; the answer carries the policy now in force and the cast narrator so a narrated cut with no narrator can be warned about before approval. Requires Idempotency-Key. Scope: story:write.

post/trailers/{jobId}/audio-policy

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/audio-policy
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Request body

audioPolicy'suppress' | 'narrate' required

narrate speaks each beat's narration in one voice; suppress is caption-carried.

Response

The audio policy now in force and the cast narrator.

audioPolicystring required
narratorVoiceIdstring nullable
narratorVoiceProviderstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.