RunningHub API icon

RunningHub API

Interact with the RunningHub API

ComfyUI Workflow → Run Workflow V2

AI-generated

Summary

Runs a published ComfyUI workflow through RunningHub’s v2 API. Optionally supplies node input overrides and runtime settings; the API response is returned as one output item per input item.

Inputs

  • Workflow ID (required) — ID of the workflow template to run.
  • Send NodeInfo List — Enable parameter overrides for workflow nodes. When enabled, provide the list as a JSON array or as structured entries with node ID, field name, value, and value type. Structured values support strings, numbers, booleans, and JSON objects or arrays.
  • Access Password — Password for an encrypted workflow.
  • Add Metadata — Whether to add workflow metadata to output images; defaults to true.
  • Webhook URL — URL to receive a POST callback when the task finishes.
  • Instance Type — Choose Auto, Default (24G VRAM), or Plus (48G VRAM). The default selection is Auto.
  • Use Personal Queue — Whether to use the personal exclusive queue; defaults to false.
  • Retain Seconds — Optional instance retention time in seconds. Intended for enterprise shared API keys; the declared valid range is 10–180 seconds, with a default of 0.

Output shape

A single JSON response item for each input item.

Calls POST /openapi/v2/run/workflow/{workflowId}. When node overrides are disabled, the request sends an empty nodeInfoList. The response is the RunningHub API response; this operation does not poll for task completion or retrieve generated outputs.

Links

Discussion