Artifacts

Apply a voice effect to a range of lines on a table read artifact.

Applies a voice effect (currently only autotune) to a contiguous range of dialogue entries [startEntryIndex..endEntryIndex] on the live read backing a table_read artifact. No new revision — the artifact id and share URLs stay stable, like a voice recast. The autotune recipe (params) is optional and partial: any omitted field falls back to the proven defaults (key D, scale minpent, strength 1.0, smooth 1, reverb chapel). Async + queued: returns { artifactId, modificationId, status }; the rendered audio is projected onto the read once the modification reaches status: "ready". Requires Idempotency-Key. Scope: artifact:publish.

post/artifacts/{artifactId}/voice-modification

Request

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

Headers

Idempotency-Keystring required

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

Request body

startEntryIndexinteger required

First dialogue-entry index in the range (inclusive).

endEntryIndexinteger required

Last dialogue-entry index in the range (inclusive).

effect'autotune'

Voice effect to apply. Defaults to autotune (the only effect today).

Response

Voice modification dispatched.

artifactIdstring required
modificationIdstring required
status'queued' | 'rendering' | 'ready' | 'failed' required

Lifecycle of the modification record.

Changes

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