Run a single node | Blitflow Docs

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 }. Every call accepts a maxCostUsd ceiling.

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).

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 },
    "maxCostUsd": 0.5,
  },
}

The result contains the output artifacts, e.g. { "outputs": { "image": { "kind": "image", "ref": "https://…" } } }.

import { BlitClient } from "@blitflow/sdk";

const client = new BlitClient({ apiKey: process.env.BLITFLOW_TOKEN });

const { outputs } = await client.ops["runs.node"]({
  node: "rd-fast",
  inputs: { prompt: "an isometric wooden desk, pixel art", seed: 7 },
  maxCostUsd: 0.5,
});

console.log(outputs.image); // { kind: "image", ref: "https://…", … }

blitflow node rd-fast \
  --input prompt="an isometric wooden desk, pixel art" \
  --input seed=7 \
  --max-cost 0.5

Progress streams to stderr; the final output artifacts print to stdout (add --json for machine-readable output). Pass a file/URL as a reference input with --input image=@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.