Rendering

Queue a cloud render

Queue a durable MP4 render from any ready owned moment set. Choose aspect ratio, framing and camera motion, caption style and appearance, saved branding, intro/outro cards, audio visualization, and an optional ordered passage subset. Use idempotency_key for safe retries.

post/api/v1/projects/{projectId}/renders

Request

Base URL: https://prismclip.com
URL: https://prismclip.com/api/v1/projects/{projectId}/renders
Auth: HTTP bearer

Path parameters

projectIdstring uuid required

Owned project ID

Headers

Idempotency-Keystring

Stable retry key; reusing it with different settings is rejected

Optional stable render retry key

Request body

moment_set_idstring uuid required

Owned ready moment-set ID; active selection is not required

aspect_ratio'original' | '16:9' | '1:1' | '9:16' required

framing'full-frame' | 'background-fill' | 'tracked' required

captionsboolean required

caption_style'progressive' | 'page' | 'scroll' required

caption_size'standard' | 'large'

style_preset_idstring

Owned saved preset ID, or default

tracking_motion'cut' | 'fast-pan' | 'smooth-follow' required

transition'hard-cut' | 'fade' required

intro_enabledboolean

outro_enabledboolean

audio_motion'waveform' | 'bars' | 'pulse'

audio_background_colorstring

audio_waveform_colorstring

crop_analysis_idstring uuid

Completed framing analysis ID returned by analyze_framing

segment_idsstring[]

Ordered subset of passage IDs; omit to render every passage

idempotency_keystring

Stable retry key; reusing it with different settings is rejected

Response

Queued render state, media URLs, and provenance identifiers.

Changes

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