Trailer

Price, then render, one trailer beat again.

The writer's priced retake: a new 480p take of one call (callId) or of every call of the beat. A beat whose plan changed since it rendered is recompiled first (free) and its new calls are priced. Each new take is checked like every take and may earn the call's one automatic retake at our cost (a line not heard or said in another character's voice, or an opening off its planned framing); a moderation refusal is released and never retried. TWO CALLS, PRICE FIRST: sent WITHOUT confirmed it prices the render and reserves nothing (quotedOnly: true, the lines, credits); sent again with confirmed: true it reserves exactly the quoted lines and queues the takes. The flag is optional rather than a required true because a field that must be true to validate cannot separate a confirmed call from an unconfirmed one. A beat whose stored compile is not ready yet is prepared in the background (its lines voiced and its shots planned), which can take a few minutes: ${RENDER_QUOTE_PREPARING_UNIT_SENTENCE} Refused before the price: a text-only beat, a beat not in the cut, a call id the beat does not have (or a call of a changed beat), and a cast member with no body figure — with the action that fixes it in details.refusal. Review or complete only. Returns a shareable per-beat previewUrl. Requires Idempotency-Key. Scope: artifact:publish — a read-only key can neither spend nor ask what spending would cost.

post/trailers/{jobId}/beats/render-clip

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/beats/render-clip
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Request body

beatIndexinteger required

Zero-based index of the beat to render.

callIdstring

One of the beat's calls (from the beats read); omit to render a new take of every call of the beat. A beat whose plan changed is recompiled first, and a call id is then refused — render the whole beat.

confirmedboolean

Omit (or false) to get the price WITHOUT spending anything. Send true only after the writer has seen that price and said go.

Response

The price (no confirmed) or the queued takes, plus a shareable beat preview link. A beat not prepared yet answers RenderQuotePreparing (status: "preparing"): ask again with the same call and inputs, under a NEW Idempotency-Key (the answer under a given key is the one the server keeps).

OR

Changes

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