Prepare the FPS rendition for one source

POST 
/api/mediasrc/prepare

Creates or reuses the constant-frame-rate rendition that /api/mediasrc/start will stream when the slot's fps differs from the media's native frame rate. Streams plain-text progress: Encoding <file> at <fps> fps (<encoder>)..., progress <seconds>/<total> lines, then one of Rendition ready: <path>, Reusing rendition: <path>, Source frame rate matches; no rendition needed. or Error: <message>. Renditions are keyed by source content hash, fps, codec and profile, so replacing a source file never reuses an old rendition, while byte-identical files share one rendition that survives until the last of them is deleted or replaced. /api/mediasrc/start performs the same preparation without progress output when it is skipped. Returns 409 while Insight pulls a network stream into the slot; use /api/mediasrc/stop first.

Request

Responses

200

Streaming progress messages. Inspect the final lines to determine whether the operation completed or failed.

400

Missing or invalid request data.

404

The requested resource was not found.

409

The resource's current state does not permit the requested operation, for example a slot that is not running, is held by an external publisher, or was stopped, reassigned, reset or unassigned while its FPS rendition was being prepared (start it again).