Trailer

Read a trailer's beats, their calls and every take.

Returns the trailer's beats as they render: each beat's plan fields and its render calls (at most 10s each) — duration, audio mode, the plate rung the render opens on, the cast on camera, the shots and the lines spoken in them, the cast's speech track — and every take with its checks: whether each line was heard in a voice of its own (voiceMissLineRefs: a line not heard, or said in a voice too like another character's — a flag; ownReadingLineRefs: a line said in the take's own voice, heard and distinct, kept and never a flag), whether it opened on its planned framing (openingMiss), whether a mouth did not do what its line asks — the speaker's not following an on-camera line, or lips moving under someone else's voice (mouthMiss, with the mouths check) — whether it was the call's one automatic retake at our cost (atOurCost), whether it was not checked for a person shown twice (duplicateNotChecked: the check could not judge it even on its retry — never a pass, and it ranks below checked takes), whether its lip sync was not checked (mouthNotChecked: no on-camera speaker's mouth could be read, even after the face locator's denser retry — never a pass and never a retake, and it ranks below a take whose mouths were measured passing), whether its lip sync is uncertain (mouthUncertain: measured, but a reading sat inside the band around its limit, so the same file could read either side of it — never a pass and never a retake, ranked below a measured pass and above a measured miss), each criterion the mouth check missed or was uncertain on, with its line, face, number and limit (mouthFindings), a content refusal (released, never retried; reference_render_provider_ip_refused is a shot refused as possibly someone else's intellectual property, whose notice names what to edit before it renders again), the selection, what a priced retake would cost, and the repair engine's state: what the take watcher saw (watch), the remedy decided and the rule that fired (repair), where a take came from (lineage: repaired from, trimmed from, or a new take after, an earlier take), what a repair cost (repairCost), what repairing it in place would cost now (repairQuote), what a free trim of it may keep (trimBounds: never into a spoken line) and, on a trimmed take, the span it kept (trim: its cut plays that length). Also the beat's cut and poster, stale when the plan changed since it rendered, the master (a 480p preview in review, finished once the finish completes), the delivery class, the warnings the finish and export carry, and reviewUrl. A read: it never compiles, renders or makes a plate. Scope: story:read.

get/trailers/{jobId}/beats

Request

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

Response

The trailer's beats, calls and takes + a browser review link.

jobIdstring required
titlestring required

The trailer's one name: the writer's own (rename_trailer), else its theme. Never a length (master.durationSeconds is the length).

status'pending' | 'draft' | 'rendering' | 'review' | 'finishing' | 'complete' | 'failed' required

Where the trailer is. A retired storyboard-era status is terminal and read-only.

shotDensity'held' | 'standard' | 'dense' required

How many shots each render of a beat carries (held, standard or dense), set when the trailer was planned. Cuts inside a render are free: it never changes the price.

reviewUrlstring nullable required

Logged-in browser link to the trailer in the Videos tab, where the cut plays — motion cannot play in a terminal.

deliveryResolution'720p' | '1080p' required

What the finish delivers: the writer's choice, else 720p.

warningsstring[] required

Warnings the finish quote and the export carry: one per flagged take the writer kept (a line not heard or in another character's voice, an opening off its plan).

Changes

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