trailer

Plan a new trailer, free

Starts planning from this conversation's screenplay and scope. Stops at a draft: no render or credit reservation. A bound source keeps its thread, and the new cut gets a fresh subject conversation. notes is explicit new-cut direction only. An in-flight plan returns planning false/alreadyRunning true and creates no thread. Poll storyJobId; approve_trailer_plan separately quotes rendering.

post/conversations/{conversationId}/trailer-plan

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/conversations/{conversationId}/trailer-plan
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Request body

notesstring
targetSecondsinteger
aspectRatio'9:16' | '16:9' | '1:1'
shotDensity'held' | 'standard' | 'dense'
titlestring

Response

Planning started with its new conversation and storyJobId, or alreadyRunning with the active job id.

planningboolean required
alreadyRunningboolean required
sourceConversationIdstring nullable required
statusstring required
storyJobIdstring
runningStoryJobIdstring
nextStep'approve_trailer_plan'

Changes

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