Lazy Render Voice

Lazy-render an article in a non-default free voice.

When a listener picks a free-tier voice via /v1/listeners/{token}/voice that the worker never pre-rendered, this endpoint produces it on demand — NO Plus/Pro gate (the on-demand /rerender path above carries that gate; this one is the free-tier counterpart so EVERY free voice works once a listener selects it).

Flow:

  1. Cache hit on (slug, voice) → 200 with audio_url.
  2. Miss → enqueue a fresh render at 'prerender' priority + 202 with a polling URL.

Auth: a valid (non-expired) listener_token is the only gate. We don't bill the listener and don't decrement any quota; the audio join the warm cache so the second listener who picks the same (slug, voice) hits step 1.

post/v1/articles/{slug}/render-voice

Request

  • Base URL: https://api.storyflo.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.storyflo.com/v1/articles/{slug}/render-voice
  • Auth: none declared

Path parameters

slugstring required

Request body

voice_idstring required
listener_tokenstring required

Response

Successful Response

unknown required

Changes

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