Run pipeline
run_pipelineStart a pipeline run in the background and return its runId immediately. Video pipelines take minutes; poll get_run for progress. Runs consume account credits. inputs is keyed by entry node id (get_pipeline lists them as entryNodes): a Text Input node takes text, an HTTP Payload node takes a JSON value, and a File node takes a URL that overrides the file placed on the canvas, so a clipping pipeline can be pointed at a new source video per run without editing the graph. An entry node left out runs with the value saved on the canvas; one with nothing saved is refused, so pass it (or "" to leave it blank on purpose), and ask the user what it should say when the request does not tell you. A key that names no entry node is refused before anything runs or is charged. Before running a pipeline you built or changed in this conversation, call estimate_run_cost, wait for the person to accept the price, and pass its quoteId here: the run starts only if the pipeline is still the one quoted, and only once, so calling again with the same quoteId (a retry, a second "yes") returns the run already started instead of charging for another. Without a quote, pass a requestId of your own for the same protection on a retry. Every run renders every node again, so to add music, narration or captions to a video an earlier run made, pass its url from get_run outputs to assemble_video (musicPrompt composes a bed) or edit_asset rather than editing the pipeline and running it again.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"pipelineId": "<pipelineId>"
},
"name": "run_pipeline"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inputs | No | ||
| preview | No | Render a cheap first look instead of the whole run: the first video step and the steps that feed it, as one Veo 3.1 Lite clip of up to 8 seconds at 720p. estimate_run_cost and a refused run quote it as `preview` when the balance does not cover the run. Only on the person's yes. Returns the pipelineId get_run needs, which is not this pipeline's. | |
| quoteId | No | The quoteId estimate_run_cost (or make_video) returned for this pipeline, once the person accepted that price. | |
| requestId | No | Any id you choose for this one request, e.g. a fresh UUID. Repeat it only when retrying this same request: a call with an id that already started a run returns that run instead of starting another. Not needed with quoteId. | |
| pipelineId | Yes | ||
| callbackUrl | No | An https URL Treza POSTs the finished run to, once, when it ends (success, partial, error or cancelled), so an automation can wait for the render instead of polling get_run. The body is the JSON get_run returns for the run, sent with the headers X-Treza-Event: run.finished and X-Treza-Delivery: <runId>. It must be https on the default port and reach a public address; a URL that does not is refused before anything runs or is charged. Each attempt waits 10 seconds for a 2xx, and a timeout, 408, 429 or 5xx is retried twice more. |