Flux by Ace Data Cloud

Flux for ComfyUI by Ace Data Cloud

Use the current FluxDify tool contracts as independent ComfyUI nodes. This package exposes all 5 Dify tool definitions and 9 fixed model IDs from source snapshot c12e4db. It calls the hosted Ace Data Cloud API; no local model or GPU is needed. Paid actions consume Credits at the current service price.

简体中文 · Ace Data Cloud · Issues

Install

When the Registry version is active, search Flux in ComfyUI-Manager, confirm publisher acedatacloud and package Flux by Ace Data Cloud, install, and restart. Registry ID: flux. Source repository: AceDataCloud/FluxComfyUI. Source code, CI, or Registry upload alone does not prove a market install.

For local source testing, clone this repository into ComfyUI/custom_nodes/FluxComfyUI and run python -m pip install -r requirements.txt in ComfyUI's environment, then restart. Native media loaders require ComfyUI 0.39.0 or newer. This package uses ComfyUI's existing image/audio/video libraries for decoding.

Key and tool inputs

Set ACEDATACLOUD_API_KEY (or ACEDATACLOUD_API_TOKEN) in the ComfyUI process environment and restart. Keep the key out of workflow JSON, screenshots, issues, and the repository.

Each Dify tool has its own node. The model and action selectors expose every fixed choice in the source YAML. Other fields appear as named text or confirmation widgets; leave one empty to omit it. parameters_json accepts the same API fields as an advanced JSON object. A nonempty widget overrides the matching JSON field; (from JSON/default) keeps a model/action supplied by JSON or the API default. Arrays and objects can be entered as JSON strings in their named widgets. Task lookup nodes also offer task_id and wait_seconds; batch lookup nodes offer ids_json. Contract validation happens before a request. Paid submissions are never retried after a connection failure; preserve an accepted task ID and inspect request history before paying again.

| Dify tool | Required fields in JSON | Model choices | Action choices | | --- | --- | --- | --- | | flux_edit_image | prompt | flux-dev, flux-pro, flux-kontext-pro, flux-kontext-max, flux-2-flex, flux-2-pro, flux-2-max, flux-2-klein | — | | flux_generate_image | prompt | flux-dev, flux-pro, flux-kontext-pro, flux-kontext-max, flux-2-flex, flux-2-pro, flux-2-max, flux-2-klein | — | | flux_generate_video | — | flux-3 | generate | | flux_task_retrieve | task_id | — | — | | flux_tasks_retrieve_batch | ids | — | — |

Import 01-configure-and-run.json with File → Open, fill its placeholder task ID or JSON parameters, then run. The example is a configuration template; it does not submit a paid request by itself. Query the same task ID until status is succeeded. The node returns status, task ID, all media URLs as JSON, first media URL, normalized result JSON, and trace ID. Connect a completed Ace CDN URL to the provided IMAGE, VIDEO loader where applicable.

Check current service pricing before a paid run. Read-only task queries and media downloads should not generate a new paid task. Destructive Dify actions still require an explicit confirm: true in JSON. See privacy notes.

Development

python -m unittest discover -s tests -v
python -m py_compile __init__.py client.py api_contracts.py nodes.py

pyproject.toml declares short Registry ID flux, publisher acedatacloud, and a 400×400 proportional resize of the canonical Ace logo.