Cast a story film's people in one step (metered — TWO CALLS, price first).
Casts a product project's STORY FILM: everyone who speaks in its screenplay (script, default the newest), plus anyone named in people who is only seen, at most 3 in all. Each person without a headshot gets 3 headshot candidates on the cast headshot model; each who speaks without a voice gets 3 candidate voices. Give each person a look and a voice unless their cast entry or persona already has one; persona copies a Bible persona into the cast with them. TWO CALLS: without confirmed it PRICES everything and writes nothing (quotedOnly: true, each person's headshots and voices, credits, balanceAfter, sufficient, note); with confirmed: true it saves the people on the cast canon (their look and age) and starts every design (people[].headshot.designId — poll GET .../cast-portraits/designs?designId= — and people[].voice.designId). Every candidate drawn is charged, chosen or not; choosing one headshot and one voice per person is free. Refused before the price: 409 cast_precondition_failed with reason story_film_cast_needs_direction (details.missing names who needs a look or a voice), story_film_cast_too_many, story_film_cast_no_people or product_cast_needs_story_film; 409 project_not_product on a story project; 404 script_not_found. 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-film
- 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 designs.
Changes
No recorded changes to this operation across all 2 revisions of this API.