什麼是 RunningHub？短劇創作者的雲端 ComfyUI 替代方案
在短劇製作過程中，ComfyUI 憑藉著精確的節點控制能力，成為許多創作者維持主角長相一致、控制人物動作與生成連續鏡頭的首選工具。然而，在本機運行 ComfyUI 往往伴隨著不低的硬體負擔：生成高清圖像需要較大顯存，視頻生成工作流對顯存與算力的要求更為嚴苛，創作者還得經常面對 CUDA 驅動升級、Python 套件衝突以及自訂節點報錯等繁瑣問題。
RunningHub 是一個基於 ComfyUI 架構的雲端工作流與 AI 應用平台。它將龐大的運算環境與模型部屬在雲端伺服器上，創作者無需自己購買或組裝高階顯卡，就能直接在線上運行現成的 ComfyUI 工作流或社群開發者封裝好的 AI 應用。透過標準的 API 接口，外部工具能夠遠端觸發這些工作流，並將生成的圖片、影片或音訊傳回本地介面。
將 RunningHub 接進短劇製作流程，最大的好處在於將「運算壓力」與「腳本創作」分開。即使手上只有輕薄筆電，創作者也能專注於分鏡構思、情節推進與機位編排，把繁重的模型採樣與影片渲染交給雲端處理。
- 免除本機硬體負擔：將消耗運算資源的算圖與算影片流程交給雲端伺服器，一般電腦也能參與製作。
- 降低環境維護成本：避開 Python 依賴套件衝突、自訂節點遺失或驅動程式不相容等常見問題。
- 標準化 API 調用：透過工作流與應用的專屬 ID，直接從外部編輯介面傳送參數並取得影音產出。
Workflow 與 AI 應用（WebApp）的差異及 ID 取得方式
在 RunningHub 平台中，任務載體通常分為兩種形式：標準的 ComfyUI 工作流（Workflow）以及封裝後的 AI 應用（WebApp）。在開始串聯 API 之前，必須先釐清這兩者的差異，因為兩者對應的識別代碼格式不同，填錯會導致 API 無法辨識欲調用的項目。
標準工作流（Workflow）是完整的 ComfyUI 節點網絡，保留了所有採樣器、提示詞編碼器與模型載入器，適合需要精細調整每一步生成細節的創作者。而 AI 應用（WebApp）則是將特定工作流打包成類似表單的輕量介面，隱藏了背後的節點連線，只露出關鍵的輸入項（如提示詞框、參考圖上傳區或畫面比例選單），適合操作固定生成任務。
無論你打算在畫布中調用哪一種，都必須在 RunningHub 網頁後台取得對應的專屬 ID，這組 ID 是 API 辨認任務內容的唯一依據。
取得 Workflow ID
打開工作流，在瀏覽器地址欄裡找到 workflowId。官方並建議：先在 RunningHub 網頁上手動把這個工作流跑通一次，再通過 API 調用，否則容易報錯。
取得 WebApp ID
打開該 AI 應用頁面獲取，通常在頁面網址裡。
確認介面暴露的輸入項
在 RunningHub 頁面上預先確認該工作流或應用暴露了哪些可輸入欄位（例如文字提示詞輸入框、圖片上傳節點名稱），這有助於後續在畫布中準確對應欄位名稱。
搞懂兩種 RunningHub API Key：積分 Key 與素材上傳 Key
串接 RunningHub API 時，許多創作者最容易感到困惑的就是金鑰的用途劃分。RunningHub 在安全機制與權限管理上，將 API Key 分成了兩套獨立的體系：積分 API Key 與企業級素材上傳 Key。搞清楚各自的分工，是確保 API 調用順暢的關鍵第一步。
積分 API Key 是你的主要調度憑證。它的職責包含拉取工作流的參數結構、提交生成任務、扣除運算點數以及查詢任務狀態與最終結果。只要涉及到「讓雲端開始運算」的動作，都需要這組金鑰。
企業級素材上傳 Key 則是一組用途高度專一的金鑰，僅用於上傳外部參考素材。如果你的工作流需要輸入角色設定圖、分鏡草圖、參考影片、配音音訊或是局部重繪的蒙版（Mask），這些檔案必須在工作流啟動前先上傳至 RunningHub 的雲端素材庫，而這個上傳動作就必須使用企業級素材上傳 Key。
換句話說，如果你的工作流純粹是文字生成圖片，不帶任何參考圖，那麼只需要填寫積分 API Key 即可運作；但對於短劇創作而言，為了盡量維持角色臉部特徵與場景氛圍的一致，通常都需要傳入人物設定圖，因此兩組金鑰皆為不可或缺。
- 積分 API Key（核心必要）：用於身分驗證、拉取工作流參數清單、提交渲染任務以及查詢產出檔案位址。
- 企業級素材上傳 Key（有參考素材時必要）：專門負責將畫布上的參考圖、參考影片、語音與蒙版等檔案安全上傳至雲端素材庫。
- 憑證保管注意事項：兩組金鑰均代表你的帳號操作權限，請妥善保管，避免張貼於公開討論區或共享文件中。
RunningHub API 常見報錯原因與逐步排查指南
使用 API 執行雲端工作流時，偶爾會遇到回傳失敗訊息的情況。大部分問題並非來自模型運算錯誤，而是前置設定上的小疏漏。掌握以下幾個常見問題的排查方向，可以幫你省下大量摸索時間。
積分不足時，請求會失敗，充值後再試。若是系統提示「身分驗證失敗」或「餘額不足」，但登入 RunningHub 官網查看時明明帳號內還有積分，通常有兩個原因：第一是金鑰填寫欄位顛倒，把企業級素材上傳 Key 填進了積分 Key 的位置；第二是複製金鑰時不小心選取了開頭或結尾的半角空格，導致字串校驗不通過。
另一個高頻問題是「任務成功執行，但生成的畫面完全忽視了輸入的提示詞或參考圖」。這多半是因為填入 ID 後沒有執行「拉取參數」，或是參數拉取後未確實將畫布變數與工作流的輸入欄位進行映射綁定，導致雲端直接使用了工作流內的預設數值。
檢查金鑰是否填反、多餘空格或積分狀態
積分不足時，請求會失敗，充值後再試。遇到驗證異常時，回到設定介面，確認積分 API Key 與企業級素材上傳 Key 是否各自填入正確欄位，並手動檢查前後是否有看不到的空格字元。
確認是否已點擊「拉取參數」
更換 workflowId 或 webappId 後，必須確實點擊「拉取參數」按鈕，讓系統重新解析該工作流目前開放的節點輸入項，不可直接跳過此步驟。
檢查欄位映射（Field Mapping）是否完整
逐一核對正向提示詞、負向提示詞、種子數值與輸入圖片的對應欄位，確認每個項目都確實指向了工作流中正確的接收節點。
確認參考素材具備上傳授權
若工作流連接著人物參考圖或蒙版，但回傳錯誤代碼顯示素材讀取失敗，請確認是否已填妥企業級素材上傳 Key，且素材格式與檔案大小符合規範。
在 DramaCanvas 中設定 RunningHub 插件與欄位映射
在 DramaCanvas 中，內建的 RunningHub 工作流插件讓創作者無需自己編寫程式代碼或架設中轉服務，就能直接在直覺的表單中完成金鑰驗證與欄位綁定。
所有填入的金鑰均由平台安全保存，插件本身不接觸敏感金鑰內容，有效保障帳號安全。更方便的是，平台支援保存多個工作流條目，你可以為短劇的不同環節分別建立配置，例如一個專門產出角色全身分鏡的圖片工作流、一個負責環境擴圖的背景工作流，以及一個將靜態分鏡轉為動態鏡頭的影片工作流。
前往插件中心啟用插件
在 DramaCanvas 頂部導航列點擊進入「插件中心」，找到 RunningHub 工作流插件並點擊啟用。接著進入需要登入帳號的「設定頁」，在左側選單點選「RunningHub」設定面板。
選擇服務站點並輸入金鑰
依據你註冊 RunningHub 的帳號類型，選擇「中國站（runninghub.cn）」或「國際站（runninghub.ai）」，若使用相容網關亦可在此填寫自訂網關地址。隨後在對應欄位分別填入你的「積分 API Key」與「企業級素材上傳 Key」。
輸入識別 ID 並點擊「拉取參數」
點擊新增條目，填入準備好的 workflowId 或 webappId，並依據輸出成果選擇用途分類（圖片、影片或音訊）。點擊「拉取參數」按鈕，系統會向 RunningHub 請求該工作流的輸入規格。
編輯欄位映射並執行測試請求
展開參數清單，將文字輸入框對應至提示詞節點，將數值輸入框對應至種子或步數節點。設定完成後，點擊「測試請求」進行連線驗證，確認能正常回傳結果後保存條目。
在短劇畫布中加入工作流節點並傳遞分鏡素材
在設定頁完成條目保存後，就能將這些雲端工作流節點放進短劇畫布中。創作者可以像排布故事分鏡一樣，在畫布中靈活調度工作流節點與各類分鏡素材。
如果在畫布的添加節點選單中找不到「工作流」項目，請檢查畫布頂部工具列的模式狀態。DramaCanvas 預設可能處於精簡的「簡潔模式」，只需點擊切換為「專業模式」，「工作流」節點選單便會完整顯示，點擊即可將其加入畫布。
加入節點後，在卡片下拉選單中選取剛才保存的 RunningHub 條目，工作流節點的參數欄位來自保存的工作流配置。創作者可以直接在節點上修改提示詞文字、調整生成參數，種子可以點骰子隨機，方便嘗試不同的構圖變化。
在素材傳遞方面，只有連到節點上的參考圖片、參考視頻、參考音訊和蒙版會按欄位配置自動填入工作流輸入（需要上傳時走企業級素材上傳 Key），免去手動下載再重新上傳的繁瑣動作。
- 確認專業模式：若在添加節點選單中找不到「工作流」，請確認畫布頂欄已從「簡潔模式」切換為「專業模式」。
- 參數配置與骰子隨機種子：工作流節點的參數欄位來自保存的工作流配置，種子可以點骰子隨機更換。
- 參考素材自動填入：只有連到節點上的參考圖片、參考視頻、參考音訊和蒙版會按欄位配置自動填入工作流輸入（需要上傳時走企業級素材上傳 Key）。
費用說明：RunningHub 雲端費用與 DramaCanvas 的計費界線
對於需要控制成本的獨立創作者或製作團隊而言，釐清各環節的費用界線至關重要。透過 DramaCanvas 插件調用 RunningHub 工作流，整體的計費架構完全透明，兩者互不疊加。
在 DramaCanvas 這端，通過 RunningHub 或 ComfyUI Bridge 運行工作流，DramaCanvas 不扣積分。不會在 DramaCanvas 帳戶內產生任何費用，所有使用者皆可自由在「插件中心」啟用插件，沒有額外的會員門檻限制。
RunningHub 的費用按 RunningHub 自己的規則收取。所有因為模型運算、採樣迭代與雲端 GPU 佔用所產生的費用，均由創作者直接在 RunningHub 平台充值與消耗，DramaCanvas 不代收任何費用，也不收取平台抽成。
常見問題
什麼是 ComfyUI 工作流？跟一般的 AI 生圖工具有什麼不同？
ComfyUI 是一種基於節點架構的視覺化生成工具，創作者能自由組合模型載入、提示詞編碼、採樣器與後處理模組。相較於一般單一輸入框的生圖軟體，ComfyUI 能精確控制多張參考圖權重、分層局部重繪以及運鏡動態，因此在要求角色長相連貫與風格統一的短劇鏡頭製作中特別實用。
使用雲端 RunningHub 跑工作流需要付費嗎？有完全免費的可能嗎？
通過 RunningHub 或 ComfyUI Bridge 運行工作流，DramaCanvas 不扣積分；RunningHub 的費用按 RunningHub 自己的規則收取。創作者可依自身製作鏡頭的數量與頻率，直接在 RunningHub 平台充值與管理點數。
製作短劇鏡頭時，要在 ComfyUI 工作流裡使用角色參考圖該怎麼傳遞？
在 DramaCanvas 設定頁中先完成工作流欄位配置。回到畫布後，只有連到節點上的參考圖片、參考視頻、參考音訊和蒙版會按欄位配置自動填入工作流輸入（需要上傳時走企業級素材上傳 Key），系統會在觸發任務時將素材安全上傳至雲端素材庫並送入工作流輸入端。
為什麼在 DramaCanvas 畫布的添加節點選單裡找不到「工作流」？
這是因為畫布目前處於「簡潔模式」。請查看畫布頂部工具列，將模式切換為「專業模式」，此時展開添加節點選單，即可看到「工作流」並將其加入畫布中使用。
可以在一個 DramaCanvas 專案中保存多個 RunningHub 工作流嗎？
可以。在 DramaCanvas 的 RunningHub 設定頁中，你可以依據短劇分鏡需求分別建立多個條目，例如專門產出角色全身特寫的圖片工作流、生成環境空鏡的風景工作流，或是將分鏡靜態圖轉為動態片段的影片工作流。在畫布的工作流節點中，只需在下拉選單切換對應的工作流名稱即可。
執行工作流時遇到提示「餘額不足」或任務失敗，該如何初步檢查？
積分不足時，請求會失敗，充值後再試。若帳號內尚有積分卻出現錯誤提示，最常見的原因是金鑰填寫位置相反。請優先前往設定頁，檢查是否誤將「企業級素材上傳 Key」填入「積分 API Key」欄位，或金鑰前後帶有額外空白字符。其次請確認工作流項目已成功執行「拉取參數」，且各欄位皆已確實映射。