Read every trailer beat's render state and credit trail.
Returns every beat's clip and text render state as the queue, the manifest and the credit ledger actually see it, with each attempt's own credit trail. Where GET /trailers/{jobId}/beats shows the plan, the takes and the cut, THIS shows why a beat reads queued / running / ready / failed / never_submitted and whether an attempt cost money. Each state is DERIVED, never asserted — ready (the asset is in the manifest, the only state that means done), queued / running (the queue still holds the recorded job id), completed (the queue finished but the asset is NOT in the manifest: the worker ran and wrote nothing durable), failed (the queue marked it failed/cancelled/expired; error carries the worker's payload), missing (a job id was recorded but the queue has no such job), unknown (the queue could not be reached — say "unknown", never guess), never_submitted (no job id and no asset). attempt is the recorded attempt INDEPENDENT of the asset — a re-render over an existing still reads state: ready while the new attempt is still queued — with its own queue state, error, creditIdempotencyKey, providerTaskId, providerModelId and its timeline (submitted → enqueued → provider-started → completed → persisted). credits is THE CREDIT TRAIL for the beat, newest first: each row's reason is its current ledger position — RESERVE (held, the worker still owes the render), CONSUME_PROVISION (settled: the render landed and the credits are spent), RELEASE (returned: the attempt died before spending). A read: it never compiles, renders, voices or makes a plate. Scope: story:read.
Request
- Base URL: https://docs.sleeperhit.studio/api/v1
- URL: https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/render-states
- Auth: HTTP bearer
Response
Every beat's clip and text render state and credit trail.
Changes
No recorded changes to this operation across all 1 revision of this API.