ComfyUI

​

概要

​

事前準備

​

EvoLink API Key の取得

1. EvoLink ダッシュボードにログインします
2. API Keys 管理ページを開き、「Create New Key」をクリックしてコピーします（sk- で始まります）

​

アカウント残高の確認

​

ステップ 1：EvoLink 公式プラグインのインストール

• 方法 A：ComfyUI 公式 Desktop
• 方法 B：aki オールインワンパッケージ
• 方法 C：git でインストール
• 方法 D：ZIP をダウンロード

1. ComfyUI Desktop を開く → 上部ツールバーの Manager をクリックしてノードマネージャーを開きます
2. evolink を検索 → Created By が evolink の EvoLink を選択 → Install をクリックします
3. 指示に従って ComfyUI を再起動します

ComfyUI 公式 Registry（registry.comfy.org/nodes/evolink-nodes）に掲載済みです。Desktop / ブラウザ版 / aki パッケージ内蔵の Manager からそのまま検索できます。

1. ランチャーから ComfyUI を起動した後、ブラウザで開いた ComfyUI の上部ツールバーで Manager → Custom Nodes Manager をクリックします

2. 検索ボックスに evolink と入力 → Author が evolink の EvoLink を選択 → Install をクリックします

3. Action 列が Restart Required になればインストール成功です → ランチャーでプロセスを終了して再起動 → ブラウザを更新します

インストール中に Neither 'pip' nor 'uv' are available for package management というエラーが表示されても、無視して構いません。本プラグインの唯一の依存関係は requests で、パッケージ環境に同梱済みのため、機能に影響はありません。Action 列に Restart Required と表示されていれば、インストールは成功しています。

ComfyUI/custom_nodes ディレクトリで次を実行します。

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

aki オールインワンパッケージのユーザー：custom_nodes は ComfyUI-aki-vX.X のインストールフォルダ内にあります。ランチャーのターミナル、またはそのディレクトリで開いた PowerShell から上記コマンドを実行してください。

1. プラグインのリポジトリを開く → 緑色の Code ボタン → Download ZIP をクリックして解凍します
2. 解凍したフォルダを ComfyUI/custom_nodes/ に移動します
3. 入れ子チェック（必須）：custom_nodes/comfyui-evolink/ を開いたとき、直下に __init__.py が見えるはずです。もし同名フォルダがもう 1 階層入っている場合（ZIP 解凍でよくある問題）、内側のフォルダを custom_nodes 直下に移動し、外側の空フォルダを削除してください

正しい構成の例：

ComfyUI-aki-v3.7\
  └─ custom_nodes\
       ├─ ComfyUI-Manager\
       └─ comfyui-evolink\
            ├─ __init__.py
            └─ ...その他のファイル

方法 A / B で Install 時に only custom nodes from the default channel can be installed というエラーが出る場合はこちら

このエラーは、プラグインのバージョンが ComfyUI 公式レジストリのセキュリティ審査中（クラウド API 系ノードでは一般的なプロセス）であるため、その間 Manager のデフォルトのセキュリティレベルがインストールをブロックすることが原因です。Manager のセキュリティレベルを一時的に下げることで解決できます。インストール後は元に戻してください。手順 1：ComfyUI を完全に終了する

• aki オールインワンパッケージ：ランチャー → プロセスを終了
• 公式 Desktop / ポータブル版 / 手動インストール版：黒いコンソールウィンドウを含め、アプリを完全に終了します

手順 2：Manager の設定ファイル config.ini を編集するインストール方式に応じてファイルを探します（見つからない場合は ComfyUI のインストールフォルダ内で config.ini を検索し、パスに manager を含むものを選びます）。

環境	config.ini の場所
aki オールインワンパッケージ	ダウンロード先\ComfyUI-aki-vX.X\ComfyUI-aki-vX.X\ComfyUI\user\__manager\config.ini
公式版（Desktop / ポータブル / 手動）	ComfyUI インストールディレクトリ\user\default\ComfyUI-Manager\config.ini

メモ帳で開き、security_level の行を探して normal を weak に変更します。

security_level = weak

保存して閉じます。

手順 3：ComfyUI を再起動して再インストールするComfyUI を起動 → Manager → evolink を検索 → Install。今度はダウンロードが始まります。Neither 'pip' nor 'uv'... のエラーが出ても前述の説明どおり無視してください。Restart Required が表示されたら、もう一度完全に再起動してブラウザを更新します。手順 4：確認してセキュリティレベルを元に戻す

• 下の「インストールの確認」に従ってノードが読み込まれていることを確認します
• ⚠️ インストール後は security_level を normal に戻すことを推奨します（手順 1・2 をもう一度実施）。これで Manager のデフォルトのセキュリティ保護が復元されます

​

インストールの確認

​

ステップ 2：最初の 1 枚を生成する（テキストから画像、5 分）

1. キャンバスの空白部分をダブルクリック（または右クリック → Add Node）→ EvoLink を検索 → EvoLink GPT Image 2 (Official) ノードを追加します（前のステップの確認時に見たノードです）
2. パラメータを入力します：
   • api_key：sk- で始まる Key を貼り付けます。入力は初回のみです。初回実行後にローカルの設定ファイルへ自動保存されるため、以降この欄は空のままで構いません（ワークフローを共有する前に空欄になっていることを確認してください）
   • prompt：画像の説明です。日本語にも対応しています。例：赤いマフラーを巻いた柴犬が雪の中に座っている、フラットイラスト風
   • その他のパラメータはデフォルトのままにします（quality=low が最も安価で、テストに最適です）
3. 表示用ノードを接続する（必須）：ノード右側の image 出力ポイントをドラッグして空白部分で離し、表示されるメニューから Preview Image を選択します。画像をローカルに保存したい場合は Save Image ノードも接続してください（画像は ComfyUI の output フォルダに書き込まれます）

4. 右上の Queue Prompt をクリックします。ノードが「タスクの送信 → 進捗のポーリング → 画像の取得」を自動で行い、進捗バーがリアルタイムで表示され、結果は Preview ノードに直接表示されます（上図参照）。

​

ステップ 3：画像から画像（3 ステップで完了）

1. Load Image ノードを追加し、ローカルの画像を選択します
2. その画像出力を EvoLink ノードの image1 ポートに接続します
3. prompt に編集内容を記述 → 実行します

• 複数の参照画像：image1～image4 の 4 つのポートすべてに画像を接続できるほか、image_urls テキストボックスに公開画像 URL を 1 行に 1 つずつ貼り付けることもできます。両方式の併用も可能で、合計最大 16 枚まで対応します
• 複雑なワークフローの構築：プラグインには EvoLink Upload Image (Official) ノードも同梱されており、ローカル画像をまとめて URL テキスト出力に変換できます（通常の画像から画像では不要です）
• すぐ使えるワークフロー：example_workflows にテキストから画像 / 画像から画像 / 複数参照画像の 3 つのサンプルがあります。各サンプルの PNG 結果画像には完全なワークフローが埋め込まれており、画像をダウンロードしてキャンバスにドラッグするだけで全ノードと接続を復元できます（ComfyUI のネイティブ機能）。同名の JSON ファイルからのインポートも可能です

​

パラメータ詳細

​

課金とセルフチェック

• 従量課金、サブスクリプションなし：タスク送信時に仮押さえ（credits_reserved）され、完了後に実際の使用量で精算されます
• 失敗 / タイムアウトしたタスクは課金されず、クレジットは自動的に返還されます
• キャッシュは課金対象外：パラメータを変えずに再実行した場合は ComfyUI のローカルキャッシュが再利用され、新しいリクエストは発生しません
• すべての消費を確認可能：タスクログページで task_id（ノード出力の 1 つ）から状態と課金を確認できます。課金に疑問がある場合は、task_id をサポートに送信すれば調査してもらえます

​

よくある質問

​

付録：プラグインなしで API を直接呼び出す

curl -s -H "Authorization: Bearer sk-あなたのキー" https://api.evolink.ai/v1/models

curl -s -X POST https://api.evolink.ai/v1/images/generations \
  -H "Authorization: Bearer sk-あなたのキー" \
  -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-あなたのキー" https://api.evolink.ai/v1/tasks/タスクID