Artifacts

Batch-update the cast (voices + avatars) on a table read artifact.

Batch-updates the cast on the table read backing this table_read artifact in one call, in place. Each entries item targets one character and may reassign its voice (voiceId / voiceName / gender / provider), request an avatar re-render (regenerateAvatar: true, with an optional avatarRefinement art-direction nudge), or both. A top-level avatarStyle restyles ALL portraits (re-renders every character against the new art-direction). Provide at least one entries item OR a top-level avatarStyle — a body with neither is rejected as validation_failed. Voice reassignments apply immediately. Avatar work is async + queue-backed: the response returns the updated voiceMap plus one avatar op { character, status, chatToolJobId } per queued render — poll GET /artifacts/{artifactId}/cast until each character's avatarStatus reaches ready. No new revision — the artifact id and share URLs stay stable, like a voice recast (no charge). Requires Idempotency-Key. Scope: artifact:publish.

post/artifacts/{artifactId}/cast

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/artifacts/{artifactId}/cast
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Request body

OR

Response

A batch that draws portraits, sent without confirmed: the price of the whole batch, nothing applied. Otherwise: cast updated, returning the merged voiceMap plus the in-flight avatar ops to poll and the credits charged.

OR

Changes

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