Projects

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).

post/story-projects/{projectId}/cast-film

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

Idempotency-Keystring required

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

Request body

scriptstring

The film's screenplay: a script or version id. Omitted: the project's newest story film.

confirmedboolean

Omit (or false) to get the price without writing or spending anything. true saves the people and starts every design, only after the writer has seen the price.

Response

The price (no confirmed) or the started designs.

quotedOnlyboolean required
projectIdstring required
scriptUploadIdstring required
titlestring required
creditsinteger required
costLabelstring nullable
balanceAfterinteger

Quote only.

sufficientboolean

Quote only.

notestring required

Changes

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