Edit asset

Run pipeline nodes over ONE video, image, or audio file the account already has and get the edited file back: captions, an upscale, background removal, lipsync, a crop, an overlay, a cutaway, a thumbnail, a trim, or any other transform in list_node_types. To put music under a video, use assemble_video with musicPrompt instead. Operations run in order, each fed the output of the one before, so "caption it and upscale it" is one call with two operations; a Transcribe stage is added wherever an operation needs a transcript. Check a node's config and ports with get_node_type first. A setting the node does not define, or a value outside what it offers, is refused with the valid ones listed. The source, and any url given as an input, must come from list_assets or a run's outputs in get_run. Renders in the background and spends credits: poll get_run with the returned pipelineId and runId. The same edit asked for again within a few minutes returns the render already started (repeat: true) rather than charging for another; to render it a second time on purpose, pass a new requestId. Needs the pipelines:run and pipelines:write scopes.

post/api/v1/tools/edit_asset

Request

  • Base URL: https://www.trezalabs.com
  • URL: https://www.trezalabs.com/api/v1/tools/edit_asset
  • Auth: HTTP bearer

Request body

sourceUrlstring required

The asset to edit, from list_assets or a run output.

namestring

What to call the render, e.g. "Captioned short".

requestIdstring

Any id you choose for this one request. A call with an id that already started a render returns that render; a new id renders again even when everything else is identical.

Response

The tool's result.

object required

Changes

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