ComfyUI

​

Overview

​

Before you start

​

Get an EvoLink API key

1. Log in to the EvoLink dashboard
2. Open the API Keys page, create a key and copy it (starts with sk-)

​

Make sure you have credits

​

Step 1: Install the official plugin

• Option A: ComfyUI Desktop
• Option B: aki all-in-one package
• Option C: git
• Option D: ZIP download

1. Open ComfyUI Desktop → click Manager in the top toolbar to open the node manager
2. Search evolink → pick the EvoLink entry whose Created By is evolink → click Install
3. Restart ComfyUI when prompted

Listed on the official ComfyUI Registry (registry.comfy.org/nodes/evolink-nodes) — searchable from the Manager in Desktop, browser builds, and packaged distributions.

1. Start ComfyUI from the launcher, then in the browser click Manager in the top toolbar → Custom Nodes Manager

2. Type evolink in the search box → pick the EvoLink entry whose Author is evolink → click Install

3. When the Action column shows Restart Required, the install succeeded → terminate and relaunch from the launcher → refresh the browser

If a Neither 'pip' nor 'uv' are available for package management error pops up during install, you can ignore it: this plugin’s only dependency is requests, which the package already bundles. As long as the Action column says Restart Required, the install worked.

Inside ComfyUI/custom_nodes, run:

git clone https://github.com/deeplearning-goethe/comfyui-evolink.git

aki all-in-one package users: custom_nodes lives inside your ComfyUI-aki-vX.X install folder; run the command from the launcher’s terminal, or open PowerShell in that directory.

1. Open the plugin repo → green Code button → Download ZIP, unzip
2. Move the folder into ComfyUI/custom_nodes/
3. Nesting check (important): opening custom_nodes/comfyui-evolink/ should show __init__.py directly. If you see another same-named folder inside (a common unzip issue), move the inner folder up and delete the empty shell.

A correct layout looks like:

ComfyUI-aki-v3.7\
  └─ custom_nodes\
       ├─ ComfyUI-Manager\
       └─ comfyui-evolink\
            ├─ __init__.py
            └─ ...other files

Option A / B install fails with only custom nodes from the default channel can be installed? Expand for the fix

This happens because the plugin’s versions are undergoing the ComfyUI registry’s security review (a common process for cloud-API nodes), and the Manager’s default security level blocks installs in the meantime. You can temporarily lower the Manager security level — and restore it afterwards:Step 1: Fully close ComfyUI

• aki all-in-one package: launcher → Terminate process
• Official Desktop / portable / manual installs: quit the app completely, including the console window

Step 2: Edit the Manager config file config.iniFind it per your install type (or just search for config.ini inside your ComfyUI folder and pick the one whose path contains manager):

Environment	config.ini location
aki all-in-one package	your-download-path\ComfyUI-aki-vX.X\ComfyUI-aki-vX.X\ComfyUI\user\__manager\config.ini
Official (Desktop / portable / manual)	ComfyUI install dir\user\default\ComfyUI-Manager\config.ini

Open it in Notepad, find the security_level line and change normal to weak:

security_level = weak

Save and close.

Step 3: Restart ComfyUI and install againStart ComfyUI → Manager → search evolink → Install. Ignore the Neither 'pip' nor 'uv'... message if it appears. Once you see Restart Required, fully restart once more and refresh the browser.Step 4: Verify, then restore the security level

• Confirm the nodes load per Verify the install below
• ⚠️ Change security_level back to normal after installing (repeat steps 1–2) to restore the Manager’s default protection

​

Verify the install

​

Step 2: Your first image (text-to-image, 5 minutes)

1. Double-click the empty canvas (or right-click → Add Node) → search EvoLink → add EvoLink GPT Image 2 (Official)
2. Fill in:
   • api_key: paste your sk- key. First time only — it is saved to a local config file after the first run; leave the field empty afterwards (and clear it before sharing workflows)
   • prompt: your description, e.g. a shiba inu wearing a red scarf sitting in the snow, flat illustration
   • Keep the other defaults (quality=low is the cheapest for testing)
3. Connect a display node (required): drag from the image output dot to empty canvas and pick Preview Image; add a Save Image node too if you want files written to ComfyUI’s output folder

4. Hit Queue Prompt. The node submits the task, polls with a live progress bar, and fetches the result, shown right in the Preview node.

​

Step 3: Image-to-image (3 steps)

1. Add a Load Image node and pick your local picture
2. Connect its image output to the EvoLink node’s image1 socket
3. Describe the edit in prompt → run

• Multiple references: sockets image1–image4 plus the image_urls text box (one public URL per line) can be mixed — up to 16 images total
• Complex workflows: the bundled EvoLink Upload Image (Official) node converts local images to URL text (not needed for regular img2img)
• Ready-made workflows: example_workflows ships text2img / img2img / multi-reference examples. Each example’s result PNG has the full workflow embedded — download the image and drag it onto the canvas to restore every node and connection (native ComfyUI behavior); matching JSON files are also provided

​

Parameters

​

Billing & self-service checks

• Pay-as-you-go, no subscription: credits are reserved at submission (credits_reserved) and settled on actual usage at completion
• Failed / timed-out tasks are not charged — credits are refunded automatically
• Cache hits are free: unchanged parameters re-run from ComfyUI’s local cache
• Every task is auditable: look up any task_id in the task logs; send the task_id to support if you have questions about a charge

​

FAQ

​

Appendix: call the API without the plugin

curl -s -H "Authorization: Bearer sk-YOUR_KEY" https://api.evolink.ai/v1/models

curl -s -X POST https://api.evolink.ai/v1/images/generations \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"a cute cat, watercolor style","size":"1:1","resolution":"1K","quality":"low","n":1}'

curl -s -H "Authorization: Bearer sk-YOUR_KEY" https://api.evolink.ai/v1/tasks/TASK_ID