build_media

Render multiple media source segments into a single output asset in a folder.

build_media

Render multiple media source segments into a single output asset in a folder.

Render a media-builder composition into destination_folder_id. Returns nothing.

Safety class: B · API type: portal · Min version: —

📘
Confinement
Class B: destination_folder_id AND every source asset must be within your run-root anchor.

Signatures

def build_media(sdk, sources, destination_folder_id, title=None,
                tags=None, collections=None, related_contents=None):
    """Render `sources` into a new output asset under destination_folder_id (confined)."""
    return sdk.build_media(
        sources, title, tags, collections, related_contents, destination_folder_id
    )

export async function buildMedia(sdk, sources, destinationFolderId, title = null,
        tags = null, collections = null, relatedContents = null) {
    // Render `sources` into a new output asset under destinationFolderId (confined).
    return await sdk.buildMedia(sources, title, tags, collections, relatedContents, destinationFolderId);
}

Parameters

Parameter (Python)	Parameter (JS)	Type	Required	Notes
`sdk`	`sdk`	Nomad_SDK	yes
`sources`	`sources`	list[dict]	yes	ordered source segments for the composition
`destination_folder_id`	`destinationFolderId`	str	yes	e.g. `<folder-uuid>`
`title`	`title`	str \| None	no	e.g. `composed.mp4`
`tags`	`tags`	list[dict] \| None	no
`collections`	`collections`	list[dict] \| None	no
`related_contents`	`relatedContents`	list[dict] \| None	no

Returns

None — no body; the rendered output lands in destination_folder_id (async).

Errors

401 unauthenticated
404 source/folder not found