Artifacts

Regenerate a single character's full-body figure on a table read artifact.

Re-renders ONE character's FULL-BODY FIGURE on the table read backing this table_read artifact, in place. The figure is the full-body cutout a render uses for that character; the avatar (POST /artifacts/{artifactId}/avatar) is the headshot the identity gate judges faces against. THEY MUST DEPICT THE SAME PERSON: when they drift apart, frames build from the figure and are judged against the avatar, so that character fails identity on every render while the rest of the cast passes. Body: { character, refinement?, referenceImageUrl? }. The figure is seeded from the character's own avatar unless referenceImageUrl overrides it. There is no style field — figure art direction follows the avatar. Async + queue-backed: enqueues a generate_figure job and returns { character, status, chatToolJobId }. Requires Idempotency-Key. Scope: artifact:publish.

post/artifacts/{artifactId}/figure

Request

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

Headers

Idempotency-Keystring required

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

Request body

characterstring required

Character cue whose figure to regenerate, e.g. "ALYOSHA".

refinementstring

Optional freeform art-direction nudge for the BODY render only. Never rewrites the headshot prompt.

referenceImageUrlstring uri

Optional already-uploaded image URL (http or https) to seed the figure from. Omit to seed from the character's avatar, which is what keeps the pair consistent.

confirmedboolean

PRICED (one image; 1 credit). Omit to get the price only (quotedOnly: true, nothing drawn or charged); send true to draw and charge.

Response

Without confirmed: the price (1 credit), nothing drawn. With confirmed: true: figure regeneration dispatched and charged.

OR

Changes

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