Design a cast member's voice from a description (metered — TWO CALLS, price first).
Draws up to four candidate voices for one named cast member (character, by canon name, alias or script cue) from description, or from the Series Bible's voice line for them when description is omitted, on the voice designer (ElevenLabs Voice Design). Each candidate is ONE TAKE of the CHARACTER'S OWN screenplay lines from this project (the design line, then previewLines more — and more of their lines when those are too short to clone a voice from), so each preview url is the character saying their own words; sampleText designs from a line of your own for a person with no lines yet. A description shorter than 20 characters is refused (400). A design never reuses a voice the character already has, so a redesign is never swallowed. TWO CALLS: sent without confirmed it PRICES the design and draws nothing (quotedOnly: true, credits — one casting voice per candidate, the price casting charges — balanceAfter, sufficient, note, and the description, designLine and previewLines it will use); sent again with confirmed: true it reserves, draws, and answers with designId and the candidates. EVERY CANDIDATE DRAWN IS CHARGED, chosen or not; choosing is free. Anyone on the project cast is reached, in an episode or not: a person with no lines in the screenplays (someone only a deck or trailer gives a line) is designed on sampleText — the line the deck gives them — or, without it, each take speaks a short passage the designer writes for the description (designLine is then null on the price). A key character's candidates are then judged by casting coverage by themselves, free (coverage on the answer; GET .../cast-voice/designs/{designId}/coverage). Then choose one with POST /story-projects/{projectId}/cast-voice/choose. Refused before the price with 409 cast_voice_precondition_failed when there is no description and no Series Bible voice line, or no voice designer is configured (details.missing voice_design); 409 voice_retired when the provider designed voices speak on has retired its voices; 409 project_precondition_failed when the project's gate holds spending. Requires Idempotency-Key. Scope: artifact:publish (billable).
Request
- Base URL: https://docs.sleeperhit.studio/api/v1
- URL: https://docs.sleeperhit.studio/api/v1/story-projects/{projectId}/cast-voice/design
- Auth: HTTP bearer
Headers
Customer-generated stable identifier for safe retries of idempotent POST requests.
Request body
Response
The price (no confirmed) or the drawn candidates.
Changes
No recorded changes to this operation across all 2 revisions of this API.