RunningHub API icon

RunningHub API

Interact with the RunningHub API

Actions25

ComfyUI Workflow → Create ComfyUI Task

AI-generated

Summary

Submits a ComfyUI workflow task to RunningHub (POST /task/openapi/create) for a given workflow ID, optionally overriding node parameters or supplying a full custom workflow JSON, and returns the API's task-creation response.

Inputs

  • workflowId (required) — ID of the workflow template to execute.
  • accessPassword — Password for encrypted workflows; sent only if non-empty.
  • addMetadata — Whether to embed workflow metadata in output images (default true).
  • sendNodeInfoList — Enable to send nodeInfoList overrides; otherwise none is sent.
  • nodeInfoListMode — JSON (paste array) or Structured Items (nodeId/fieldName/fieldValue rows).
  • nodeInfoList — JSON array of {nodeId, fieldName, fieldValue} overrides, used in JSON mode.
  • nodeInfoItems — Structured rows with Node ID, Field Name, and a value typed as string, number, boolean, or JSON. Rows missing nodeId or fieldName are dropped.
  • webhookUrl — URL RunningHub POSTs to when the task finishes.
  • workflow — Full custom workflow JSON, parsed and sent to replace the stored template.
  • instanceType — Auto (not sent), default (24G VRAM), or plus (48G VRAM).
  • usePersonalQueue — Use the personal exclusive queue; sent only when true.
  • retainSeconds — Instance retention time, 10–180 seconds. Enterprise shared API keys only; sent only when greater than 0.

Output shape

One JSON item per input item containing RunningHub's raw create-task response. This is typically a task ID and status, but the exact fields come from the API and aren't defined in the source.

It only creates the task and doesn't wait for completion. Use the Task Query operations or a webhook to get status and outputs. The node requires a license key in the credentials, validated against an external license server before running. With Continue On Fail, errors are returned per item.

Examples

Example 1: Run a stored text-to-image workflow with a custom prompt and seed

Set Workflow ID, enable Send NodeInfo List, choose Structured Items, and add rows for the prompt text node (fieldName text) and the seed node (Number type).

Example 2: Get a callback when a long render finishes

Set Workflow ID and Webhook URL to an n8n Webhook node URL, then use Query Task Output V2 with the returned task ID.

Example 3: Run on a bigger GPU

Set Workflow ID and set Instance Type to Plus (48G VRAM).

Links

Discussion