Streamline Your Image Processing with ComfyUI Workflows: A Developer's Guide

21 Apr 2025
Streamline Your Image Processing with ComfyUI Workflows: A Developer's Guide

In today's digital landscape, efficient image processing is essential for developers working with media-rich applications. The fofr/any-comfyui-workflow Cognitive Actions provide a powerful way to execute ComfyUI workflows that can handle images, videos, and more, producing outputs in popular formats like webp, jpg, or png. With pre-built capabilities for file handling, output settings, and advanced features such as randomized seeds and cache management, these actions can significantly enhance your application's functionality.

Prerequisites

Before diving into the integration of Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform, which you will use for authentication in your requests.
  • Basic familiarity with JSON and Python, as this guide will include code examples in Python to illustrate how to invoke the actions.

To authenticate your requests, you'll typically pass your API key in the headers of your HTTP requests.

Cognitive Actions Overview

Execute ComfyUI Workflow

The Execute ComfyUI Workflow action is designed to process input files and render outputs based on specified workflows defined in JSON format. This action allows you to customize various aspects of your workflow, such as input handling, output settings, and debugging options.

Input

The input schema for this action includes the following properties:

  • inputFile (string): The URI of the input image, video, tar, or zip file. You can also provide URLs in your JSON workflow for the model to download them.
  • outputFormat (string): Specifies the format of the output images. Options are 'webp', 'jpg', or 'png', with 'webp' as the default.
  • workflowJson (string): Defines your ComfyUI workflow as a JSON string or URL. Refer to the ComfyUI documentation to obtain the API version.
  • outputQuality (integer): Defines the quality of the output images on a scale from 0 to 100, with a default value of 95.
  • randomizeSeeds (boolean): Determines whether to automatically randomize seeds; defaults to true.
  • forceResetCache (boolean): If set to true, the ComfyUI cache will be reset before running the workflow, useful for debugging.
  • returnTempFiles (boolean): If true, returns any temporary files, such as preprocessed controlnet images, for debugging.

Here's an example input payload:

{
  "outputFormat": "webp",
  "workflowJson": "{\n  \"3\": {\n    \"inputs\": {\n      \"seed\": 156680208700286,\n      \"steps\": 10,\n      \"cfg\": 2.5,\n      \"sampler_name\": \"dpmpp_2m_sde\",\n      \"scheduler\": \"karras\",\n      \"denoise\": 1,\n      \"model\": [\n        \"4\",\n        0\n      ],\n      \"positive\": [\n        \"6\",\n        0\n      ],\n      \"negative\": [\n        \"7\",\n        0\n      ],\n      \"latent_image\": [\n        \"5\",\n        0\n      ]\n    },\n    \"class_type\": \"KSampler\",\n    \"_meta\": {\n      \"title\": \"KSampler\"\n    }\n  },\n  ...\n}",
  "outputQuality": 80,
  "randomizeSeeds": true,
  "forceResetCache": false,
  "returnTempFiles": false
}

Output

When successfully executed, this action returns a URL to the output image(s). An example output URL is as follows:

[
  "https://assets.cognitiveactions.com/invocations/080bfce7-abf5-474f-994b-a29b2267d2ee/969f70b4-0ab2-4159-825e-cbd337621656.webp"
]

Conceptual Usage Example (Python)

Here's how you might call the Execute ComfyUI Workflow action in Python:

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"  # Hypothetical endpoint

action_id = "880753d5-eb8c-448c-b086-cc5902d2457f"  # Action ID for Execute ComfyUI Workflow

# Construct the input payload based on the action's requirements
payload = {
    "outputFormat": "webp",
    "workflowJson": "{\n  ...\n}",  # Use your actual workflow JSON here
    "outputQuality": 80,
    "randomizeSeeds": true,
    "forceResetCache": false,
    "returnTempFiles": false
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload}  # Hypothetical structure
    )
    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body: {e.response.text}")

In this code snippet, replace the placeholders with your actual API key and workflow JSON. The action ID and input payload are structured to meet the requirements of the Execute ComfyUI Workflow action.

Conclusion

Integrating the fofr/any-comfyui-workflow Cognitive Actions into your application can significantly enhance your media processing capabilities. With the ability to execute complex workflows efficiently, you can focus more on building features that matter to your users. Whether you're looking to automate image rendering or streamline video processing, these actions provide a solid foundation for your development efforts. Explore further use cases and consider how these capabilities can be tailored to meet your specific application needs!

← Back to All Articles