Run a single node
Execute one node by id with inputs — no workflow needed.
The fastest way to get output: pick a node from the
palette, pass its inputs, and run it. Inputs and
outputs are artifacts; an image input is a
reference { kind: "image", ref }.
This example runs rd-fast with a text prompt and gets back an
image. All tabs call the same contract op, runs.node (scope: run).
To do it without writing any code, open the studio's Nodes section, pick a node, and fill in the form — it is generated from the node's spec, so the widget for each input already enforces that port's enum values and bounds. Image, audio, video and file inputs take a local file too: drop one on the field (or use its upload button) and it is stored as an owned artifact whose ref fills the field. The run is charged to the organization whose dashboard you are in.
Call the runs_node tool with the node id and its inputs:
{
"name": "runs_node",
"arguments": {
"node": "rd-fast",
"inputs": { "prompt": "an isometric wooden desk, pixel art", "seed": 7 },
},
}The result contains the output artifacts, e.g.
{ "outputs": { "image": { "kind": "image", "ref": "https://…" } } }.
Over plain HTTP runs.node isn't served yet — wrap the node in a minimal
one-node workflow and use POST /v1/runs. To chain several
nodes, build a workflow.