你是否厭倦了每次想換個模型就要重新搭建一套工具鏈？現在，透過ComfyUI-relayapi這個開源專案，你可以在 ComfyUI 中接入任意中轉站 API，輕鬆呼叫 GPT Image 2、Gemini、Veo 等主流 AI 模型，實現影像、影片、音訊的一站式生成。
使用自訂節點在 ComfyUI 中呼叫任意 API
ComfyUI-relayapi 是一個輕量級、開箱即用的自訂節點包。它透過統一的設定介面，幫助使用者在 ComfyUI 工作流程中便捷地呼叫各類第三方中轉站 API。無論是文字生成、影像創作、影片製作還是音樂合成，一個節點就能搞定。
https://github.com/flywhale-666/ComfyUI-relayapi.git
核心功能
該專案提供 5 個核心節點，分類清晰：
Relay API Settings：統一設定任務類型、平台、API 格式、中轉站位址、模型與金鑰
Relay Text Generator：文字生成、多輪對話及多圖視覺理解
Relay Image Generator：文字生成圖片、影像編輯／參考圖融合
Relay Video Generator：影片生成（支援 Grok/Veo，內建非同步任務建立與狀態查詢）
Relay Sound Generator：AI 音樂生成（深度適配 Suno 介面）
安裝方法
將專案克隆或下載至 ComfyUI 的自訂節點目錄：
ComfyUI/custom_nodes/ComfyUI-relayapi/重新啟動 ComfyUI
在節點搜尋欄輸入
RelayAPI，即可看到所有相關節點
支援的模型類型
目前支援的任務類型和內建模型：
文字生成：gemini-3.1-flash-lite-preview、claude-opus-4-6 等（支援 openai_style/gemini_style 格式）
影像生成：gpt-image-2、nano-banana-pro、gemini-3-pro-image-preview 等
影片生成：grok-video-3、veo3.1、veo3.1-fast（支援 V1/V2 介面）
音樂生成：Suno V3～V5.5 完整對應（chirp-v3.0 到 chirp-fenix 系列）
設定與使用教學
第一步：新增 Settings 節點
在畫布中新增Relay API Settings節點，這是所有生成的上游設定中心。你需要設定：
task_type（任務類型）：text/image/video/sound
platform（平台）：gemini_style、openai_style 或 relay_api_style 等
model（模型名稱）：如
gpt-image-2apikey（API 金鑰）：你的中轉站 Key
custom_api_base（選填）：自訂中轉站位址
第二步：連接生成節點
將 Settings 節點的info輸出線連接至對應生成節點，如Relay Image Generator。然後設定輸入參數：
Prompt（提示詞）
比例／解析度
參考圖（影像編輯時可選）
第三步：執行與輸出
點選「Queue Prompt」即可開始生成。所有節點均回傳response（精簡 JSON），包含狀態碼、耗時、用量等資訊，方便偵錯。
推薦的中轉站平台
以下是幾個效能穩定、價格透明的中轉站，支援 ComfyUI-relayapi 接入：
球球 token 平台：免費註冊 - 提供 GPT Image 2、Opus、Gemini 等主流模型，延遲低、並發高
luchikey API：免費註冊 - 支援多種模型呼叫，價格實惠
聰明 AI：免費註冊 - 實惠 GPT
！！重要提示：API 中轉站都有跑路風險！小額嘗鮮，少量多次，切勿大額商用。
注意事項與優化建議
API Key 匹配：Key 必須與 api_base 嚴格對應，混用會導致空回應錯誤
非同步任務處理：影片與音樂生成採用「提交-輪詢」機制，節點會自動處理從建立到查詢的全流程
解析度限制：部分中轉站／模型通道可能忽略高解析度參數（如請求 1080P 實際回傳 720P），屬服務端限制
安全過濾：若觸發內容審核，會回傳
PUBLIC_ERROR_UNSAFE_GENERATION防卡死優化：影片回應中的 Base64 圖片會被截斷為長度提示，避免 UI 卡頓
常見問題
Q：如何新增新的中轉站位址？
A：在 Settings 節點的custom_api_base欄位直接輸入新位址即可；輸入delete:位址可刪除舊位址。
Q：設定檔在哪裡？
A：設定自動儲存至專案根目錄的relay_config.json。⚠️切勿將包含真實 API Key 的設定檔提交至公開倉庫。
Q：支援哪些影片生成模型？
A：目前內建 grok-video-3、veo3.1、veo3.1-fast，透過 V1/V2 介面呼叫。
