Trailer

Choose the cut's aspect ratio.

Choose the cut's shape — 9:16 (the default), 16:9 or 1:1 — sent as { aspectRatio }. Free to store, and the useful moment is BEFORE the first render: a shape change never re-renders on its own. On a cut that already rendered, every beat whose takes are at the old shape is kept playable but flagged clipStale (its text layer goes, because it was burned at the old frame); rendering it again recompiles at the new shape, and invalidatedBeats names the beats now stale. Refused (409) while a render or finish pass is running. Requires Idempotency-Key. Scope: story:write.

post/trailers/{jobId}/aspect

Request

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

Headers

Idempotency-Keystring required

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

Request body

aspectRatio'9:16' | '16:9' | '1:1' required

The shape to switch the cut to.

Response

The cut's shape and the beats now stale at the old one.

Changes

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