Trailer

Cast the narrator for this cut.

Choose the voice that narrates this trailer, or send voiceId: null to clear it (the cut then narrates in the cast canon's NARRATOR when the canon casts one). The narrator belongs to the TRAILER: it need not be a cast member and need not match the table read's narrator. Storing the choice costs nothing — the voice is spoken at render — and re-casting is cheap, because narration is a separate track mixed over the finished cut, so a change re-renders audio and never a frame. Requires Idempotency-Key. Scope: story:write.

post/trailers/{jobId}/narrator

Request

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

Headers

Idempotency-Keystring required

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

Request body

voiceIdstring nullable required

Studio voice id, or null to clear the narrator.

provider'cartesia' | 'elevenlabs' | 'openai' | 'deepgram' | 'hume' | 'null' nullable

The voice's provider. Inferred when omitted.

Response

The cast narrator.

Changes

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