ComfyUI Remote API Orchestration Protocol

Use this protocol when you need to execute a workflow on a remote ComfyUI server (e.g., SPARK or Dual-3090) rather than locally.

1. Discovery Phase

Before submitting, verify the target environment and locate the workflow.

• Find Workflow: Use find via terminal to locate .json files if the path is unknown.
• Verify Connectivity: Always run a connectivity check (curl -s --max-time 5 http://<IP>:<PORT>/object_info) before attempting submission.

2. Injection Phase (Python)

Do not rely on shell commands for injection; use Python to ensure JSON integrity.

1. Load: json.load(f) the workflow.
2. Locate Nodes: Iterate through workflow.items() to find target nodes by class_type (e.g., CLIPTextEncode, KSampler, SaveImage).
3. Modify: Inject values into the inputs dictionary of the identified node ID.
4. Payload Wrap: Wrap the modified dict in: {"prompt": workflow, "client_id": "<uuid>"}.

3. Execution & Monitoring Phase

Submit via curl and implement a robust polling loop.