Projects

Generate the project cast (price first, draw on a confirmed second call).

With scriptUploadId, quote the full episode cast first, then confirm with that quoteId to reserve Studio Credits and enqueue voices plus headshots, body shots and character sheets. Poll GET with the same scriptUploadId; Table Read requires complete casting. Without scriptUploadId this is the separate project Bible visual cast.

post/story-projects/{projectId}/cast

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/story-projects/{projectId}/cast
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Request body

scriptUploadIdstring

Which finalized episode to cast. Omit for project-level Bible visuals.

charactersstring[]

Limit to these character names (case-insensitive). Omit to cast everybody castable. Episode casting gives NARRATOR a voice but no images.

forceboolean

Re-draw Face, Body and Sheet even where art already exists (only images, when given). This REPLACES pictures the writer may have chosen.

imagesstring[]

Narrow the cast to these pictures and no voices: face (the headshot), body (the body shot), sheet (the character sheet). With force they are drawn again: the Redraw on the project's Cast page, a body shot or sheet drawn from the person's chosen headshot and checked against it. Priced per picture; two calls (the quote's quoteId confirms). With scriptUploadId it narrows that episode's cast. WITHOUT scriptUploadId it redraws people on the project cast canon, including people no episode names: body and sheet only (a headshot is redrawn as candidates, POST /cast-portraits/design; face is a 400), the chosen headshot is kept, and each picture is written onto the cast canon (a ProjectCastRedrawQuote, then a ProjectCastRedrawQueued; read the cast until redraw is complete). A body shot or sheet for a person with no headshot is refused (409 cast_precondition_failed, details.reason: "cast_face_missing").

quoteIdstring

Required when confirming episode casting or a picture redraw; returned by its quote.

confirmedboolean

Omit (or false) to get the price and the plan WITHOUT drawing anything. Pass true only after the writer has seen that plan and said go.

Response

The quote, durable episode casting job, or completed project Bible visual cast.

Changes

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