Make a trailer from the project's app captures alone, with no screenplay (free).
A capture-only trailer is a NEW draft trailer for the whole project with no screenplay behind it: its beats play the project's app captures exactly as recorded (and title cards), never filmed footage. Creating it is free. captureId seeds beat 1 with a ready capture, the whole of it or the stretch captureKeep keeps (a capture longer than 30 seconds opens on a kept stretch of 4 to 30 seconds); without one, beat 1 is a title card with the trailer's title. Add a beat per capture (insert a beat, then refine it with compositionKind: 'capture' and the captureId). Approving the plan needs at least one capture beat and renders nothing: it assembles the cut from the captures, and only a title card's text layer is ever priced. A beat that would be filmed is refused (trailer_capture_only): there is no screenplay to film from. captureOnly: true is required (a planned trailer is made from a story plan). captureId is checked before anything is stored, with the stretch captureKeep keeps of it when one is sent (a capture longer than 30 seconds opens on a kept stretch of 4 to 30 seconds; captureKeep without captureId is 400): a capture that is not the project's, not ready, a raw master, playing outside 4 to 30 seconds, a kept stretch that does not fit it, or in another shape than aspectRatio is refused with 409 trailer_state_invalid (details.refusal.code names the problem: trailer_capture_raw, trailer_capture_length, trailer_capture_keep_range, trailer_capture_keep_cuts_result, trailer_capture_shape, trailer_capture_not_ready, trailer_capture_rejected) or 404 capture_not_found, and no trailer is made. NOT metered and NOT confirmed. Requires Idempotency-Key. Scope: story:write. Only a product project whose workspace gate is open makes one, as the Videos page offers it only then: a story project is refused with 409 project_not_product, and a product project whose product Bible is not complete or whose product coverage has not passed with 409 project_precondition_failed (details.stage names the stage), before anything is stored.
Request
- Base URL: https://docs.sleeperhit.studio/api/v1
- URL: https://docs.sleeperhit.studio/api/v1/story-projects/{projectId}/trailers
- Auth: HTTP bearer
Headers
Customer-generated stable identifier for safe retries of idempotent POST requests.
Request body
Response
The new draft trailer.
Changes
No recorded changes to this operation across all 2 revisions of this API.