短劇工作室的創(chuàng)作流程正在從單機拼素材升級為團隊協(xié)作生產(chǎn)。較常見的狀態(tài)是幾個人共用一臺設備傳遞工程文件AI 模型要么全走網(wǎng)頁端要么各自用本地工具腳本、角色設定和分鏡描述散落各處。JaceCanvas 這次大更新把 API、本地、服務器三種模型接入方式統(tǒng)一到同一套連接體系里正是為了解決這個協(xié)作問題。新版本的思路并不復雜畫布里每一個 AI 節(jié)點不再直接綁定某一個模型服務商而是先選擇一個連接器。連接器決定請求發(fā)到遠程 API、發(fā)到本機 Ollama還是發(fā)到工作室自建的 JaceCanvas Server。這樣同一張畫布可以混合使用多個模型來源換服務商時不用重做節(jié)點短劇項目組也能按角色、按素材敏感程度分配不同的運行后端。下面按照“理解架構(gòu)、準備環(huán)境、配置 API、加載本地模型、接入服務器、落地工作流、排查故障、固化規(guī)范”的順序展開。前兩節(jié)偏概念和準備第三節(jié)開始都是可以直接照著做的內(nèi)容。1. 先理解這次更新的核心畫布內(nèi)容與模型后端解耦1.1 JaceCanvas 是一條內(nèi)容編排鏈路不是單機畫圖板很多創(chuàng)作者第一次接觸 JaceCanvas 時會把它理解為“一個可以拖圖層的畫布”。但在短劇工作室里它的作用更接近“分鏡生產(chǎn)流水線”左側(cè)放劇本段落、人物小傳、場景描述、參考圖中間用節(jié)點把素材連接起來右側(cè)讓 AI 模型生成臺詞潤色、畫面提示詞、角色設定圖或視頻片段。這種工具本質(zhì)上是一個內(nèi)容編排系統(tǒng)。畫布上的節(jié)點負責兩類事情內(nèi)容節(jié)點保存文本、圖片、視頻片段、標簽等素材。處理節(jié)點把前面的素材作為輸入交給某個模型或算法處理后再輸出給后面的節(jié)點。處理節(jié)點要能工作必須知道“去哪里調(diào)用模型”。舊版本常見做法是每個處理節(jié)點在配置里寫死一個服務商 SDK例如直接填 DeepSeek 的 API Key 或某個本地腳本地址。短劇項目一旦多了問題馬上出現(xiàn)同一個角色設定想在 DeepSeek、智譜、本地開源模型之間對比效果需要逐個節(jié)點改配置。外地團隊成員連不上工作室電腦上的本地模型只能退回網(wǎng)頁版手動復制粘貼。想給整個項目統(tǒng)一設置模型參數(shù)沒有中心化入口只能靠人工同步。這次更新把模型訪問統(tǒng)一收斂為“連接器”。畫布節(jié)點不再關心背后是哪個服務商、哪臺機器它只需要知道連接器的名字和模型名。連接器負責處理協(xié)議差異、鑒權(quán)、超時和錯誤信息并把結(jié)果以統(tǒng)一格式返回給節(jié)點。1.2 API、本地、服務器三種模式分別解決什么問題三種模式不是競爭關系它們對應短劇工作室不同階段的資源訴求。模式模型運行位置成本結(jié)構(gòu)數(shù)據(jù)邊界典型使用場景API 模式模型服務商的遠端服務器按 Token 或按次計費有免費額度但生產(chǎn)用量會付費請求內(nèi)容會發(fā)送到第三方服務使用前要確認數(shù)據(jù)協(xié)議快速驗證模型效果、跑高質(zhì)量長文本、補充本地模型不擅長的能力本地模式本機或工作室內(nèi)網(wǎng) GPU 機器沒有單次調(diào)用費用但需要購買算力硬件、維護環(huán)境數(shù)據(jù)不出工作室適合未公開劇本和敏感角色資料離線創(chuàng)作、隱私素材處理、高頻低成本的批量文案生成服務器模式自建服務器或云主機上的 JaceCanvas Server需要承擔服務器、存儲、帶寬和備份成本數(shù)據(jù)集中在服務器統(tǒng)一管理可控性最強團隊多人協(xié)作、統(tǒng)一素材庫、統(tǒng)一權(quán)限和任務調(diào)度這里的核心取舍點是“數(shù)據(jù)邊界”和“成本結(jié)構(gòu)”。短劇的核心資產(chǎn)是劇本、人物關系和分鏡設計思路這些內(nèi)容一旦發(fā)給外部 API就進入服務商的處理鏈路。公開發(fā)布前的半成品腳本是否適合外發(fā)工作室要提前判斷。本地模式能規(guī)避這個問題但對硬件和部署運維能力有要求。服務器模式則更像是把整個工具搬到團隊內(nèi)部讓成員不直接接觸模型服務商而是通過 JaceCanvas Server 統(tǒng)一分發(fā)請求。1.3 對短劇工作室來說這次更新的真正價值短劇工作室使用 AI 的痛點是“混合調(diào)用”。編劇起草臺詞時希望用上下文能力強的遠程大模型角色一致性測試時希望本地模型不泄露角色設定渲染和批量生成時又希望團隊所有人共用同一個任務入口。三端打通后工作室可以按內(nèi)容類型規(guī)劃路徑劇本初稿、世界觀大綱適合 API 模式快速、長上下文、生成質(zhì)量相對穩(wěn)定。角色小傳、未公開分鏡適合本地模式防止重要創(chuàng)意外流。團隊共用的素材庫、交付文件、歷史版本適合服務器模式集中存儲。使用時要避免一個誤區(qū)不要把所有模型請求都集中在一個模式上。API 不等于“最好”本地模型也不等于“絕對安全”。關鍵看請求內(nèi)容是什么、誰能訪問運行環(huán)境、失敗后如何重試。注意連接器只是打通了網(wǎng)絡和協(xié)議并沒有自動解決內(nèi)容安全。請求發(fā)到遠程 API 前仍要閱讀服務商的數(shù)據(jù)使用條款發(fā)到本地模型前也要確認模型權(quán)重本身的許可協(xié)議是否允許商用。2. 環(huán)境準備先安裝工具再確認三種底座各自的前置條件2.1 安裝 JaceCanvas 并先找到連接中心不同操作系統(tǒng)的安裝包不同但新版本基本都會提供桌面客戶端和服務端安裝包。安裝完成后先不要急著建項目打開設置頁面找到“連接中心”或“連接器管理”入口。如果入口名稱不同直接在應用內(nèi)搜索“API”或“連接”通常也能定位。建議在開始配置前記錄當前版本號。版本號會影響菜單名稱和字段結(jié)構(gòu)后續(xù)排錯時版本信息可以幫助判斷問題是配置錯誤還是版本差異。新舊版本升級后如果發(fā)現(xiàn)原來的連接器不見了大概率是配置結(jié)構(gòu)不兼容需要按新版的字段重新填寫。不要用舊版本的導出配置直接覆蓋新版先對比字段再導入。2.2 API 模式要準備四類信息API 模式配置前需要向模型服務商確認四類信息缺一個都會導致節(jié)點運行失敗API Key用于鑒權(quán)的密鑰通常在服務商控制臺創(chuàng)建。Base URLAPI 的請求地址通常是包含版本號的路徑?？捎媚Ｐ兔斜矸丈讨С值哪Ｐ兔Q必須與服務商文檔一致。計費規(guī)則和速率限制確認每分鐘請求數(shù)、上下文長度、超出后的表現(xiàn)。如果是在公司或工作室環(huán)境中通過統(tǒng)一網(wǎng)關訪問模型還需要確認網(wǎng)關要求的請求頭格式例如是否要額外填寫工作空間 ID 或項目 ID。JaceCanvas 的連接器一般會提供請求頭擴展字段這類信息可以寫在那里。準備 API Key 時不要直接把它填寫在多人共享的演示畫布里。連接器配置通常只保存在本機配置文件中但團隊協(xié)作時會同步項目文件。如果項目文件打包了密鑰等于把密鑰連同畫布一起發(fā)給了所有成員。正確做法是先確認連接器是否支持引用環(huán)境變量或系統(tǒng)密鑰串如果支持優(yōu)先使用環(huán)境變量。2.3 本地模式要準備一個可用的模型服務本地模式并不是把模型文件直接拖進 JaceCanvas。JaceCanvas 作為畫布客戶端需要通過本地模型服務提供的 HTTP 接口來調(diào)用模型。目前比較常用的方案有兩種Ollama啟動快、命令簡單適合在單機或內(nèi)網(wǎng) GPU 服務器上部署開源模型。LM Studio提供圖形界面適合先在 Windows 或 macOS 機器上手工加載模型并測試效果。準備 Ollama 環(huán)境時建議先確認版本和服務狀態(tài)ollama --version ollama list如果已經(jīng)拉過模型ollama list會輸出模型名、標簽和大小。此時可以啟動服務并檢查接口是否可訪問curl http://127.0.0.1:11434/api/tags正常返回時會在終端看到類似 JSON 的模型列表。如果返回連接拒絕說明 Ollama 服務沒有啟動需要在終端運行ollama serve或通過系統(tǒng)服務啟動。本地模式在開發(fā)環(huán)境可以只跑在127.0.0.1但如果要讓工作室其他成員也使用這臺機器上的本地模型需要讓服務監(jiān)聽局域網(wǎng)地址。Ollama 可以通過環(huán)境變量控制監(jiān)聽地址OLLAMA_HOST0.0.0.0 ollama serve改為監(jiān)聽所有網(wǎng)卡后必須同時考慮訪問控制。不要直接把監(jiān)聽地址暴露到公網(wǎng)否則任何人都可能調(diào)用你的模型并消耗算力。實踐中更穩(wěn)妥的做法是在內(nèi)網(wǎng)使用或在前面加一層只允許工作室 IP 訪問的防火墻規(guī)則。2.4 服務器模式要準備一臺可用于部署的主機服務器模式依賴 JaceCanvas Server 服務端。它負責接收客戶端的畫布和節(jié)點請求再統(tǒng)一轉(zhuǎn)發(fā)到 API 或本地模型。部署前要準備一臺 Linux 主機建議至少 2 核 4GB 內(nèi)存如果還要在服務器上直接跑本地模型則要根據(jù)模型參數(shù)量配置相應的 GPU 顯存。先梳理一個環(huán)境檢查清單檢查項學習環(huán)境工作室生產(chǎn)環(huán)境操作系統(tǒng)Windows、macOS、Linux 均可建議 Ubuntu 22.04 LTS 或兼容 Linux客戶端版本最新穩(wěn)定版與團隊成員統(tǒng)一固定版本API Key可用測試額度即可使用獨立項目或子賬號不要用個人 Key本地模型服務能返回模型列表即可確認 GPU、顯存、并發(fā)能力和磁盤空間服務器端口只在本機測試可不開放按安全組白名單開放并配置 HTTPS數(shù)據(jù)備份不強制必須有數(shù)據(jù)目錄定期快照和恢復演練賬號權(quán)限單人使用按編劇、分鏡、剪輯、管理者拆分角色這個清單最大的作用是避免在部署階段把學習環(huán)境配置直接當成生產(chǎn)配置。學習環(huán)境可以容忍“密鑰寫在配置文件里、數(shù)據(jù)不備份、服務沒有日志”生產(chǎn)環(huán)境不能容忍。進入第 5 節(jié)前建議先把上表逐項核對完。3. API 模式接入把主流模型供應商變成同一個畫布節(jié)點3.1 新增一個 API 連接器的標準流程進入連接中心后選擇“新增連接器”再選擇 API 類型。JaceCanvas 里的連接器通常兼容 OpenAI Chat Completions 協(xié)議因此多數(shù)模型服務商可以按同一套字段填寫。字段名稱可能因版本不同略有區(qū)別但核心結(jié)構(gòu)一致。新增連接器需要完成三件事連接器名稱給工作室內(nèi)部看的名字建議按用途命名例如“劇本-api”或“測試環(huán)境”。服務地址與鑒權(quán)填寫 Base URL 和 API Key。默認模型與參數(shù)填寫模型名稱和合理的默認值。這里的關鍵是“節(jié)點只認連接器名稱不認服務商地址”。因此建議給連接器命名時帶上用途而不是服務商名。例如一個連接器可以對應同一個服務商下面不同的模型策略命名成“長文本-劇本草稿”比“DeepSeek-國內(nèi)節(jié)點”更清晰后續(xù)切換服務商時畫布節(jié)點不需要改動。3.2 關鍵參數(shù)說明API 連接器參數(shù)中最容易出問題的不是 API Key而是 Base URL 和模型名。下面表格列出了需要重點確認的參數(shù)參數(shù)說明注意事項Base URL模型服務的 HTTP 訪問地址要確認是否包含/v1不同服務商開放接口路徑不完全一致API Key調(diào)用模型時的身份憑證不要含換行不要在前后加多余空格復制時最好手動前后補齊模型名遠端服務的模型標識必須和服務商文檔一致不能自己猜也不要粘貼中文名Temperature采樣隨機性越高越發(fā)散短劇文案建議先 0.7角色一致性任務降到 0.2 左右Max Tokens單次生成的最大 Token 數(shù)不是模型整體的上下文長度它只是限制本次輸出長度Timeout請求超時時間長劇本分析建議調(diào)大短提示詞可以保持默認附加請求頭網(wǎng)關、工作空間需要的自定義頭沒有網(wǎng)關需求時保持為空配置時最容易出現(xiàn)的錯誤是“Base URL 多寫了一層路徑”。例如服務商文檔給出的是https://api.example.com/v1/chat/completions但在連接器里應該填寫https://api.example.com/v1而不是把完整的chat/completions也填進去。連接器通常會自動拼接/chat/completions。把完整接口路徑填進去反而會導致請求地址多出一段返回 404。3.3 一個典型的 API 連接器配置示例下面是一個基于 OpenAI 兼容協(xié)議的連接器配置示例用來說明結(jié)構(gòu)。實際字段以安裝版本界面為準{ connector: { name: api-longtext-script, type: openai-compatible, baseUrl: https://api.example.com/v1, apiKey: sk-xxxxxxxx, models: [ deepseek-chat, glm-4-plus ], request: { temperature: 0.7, maxTokens: 4096, timeoutSeconds: 120 } } }這段配置的用意是定義“一個用于長文本生成的外部 API 連接器”。name字段會在畫布節(jié)點下拉框里顯示models數(shù)組是可選擇的模型列表不是同時調(diào)用多個模型request中的參數(shù)是畫布節(jié)點未指定參數(shù)時的默認值。模型名這一項在這里只做了示例展示。實際部署時要以模型服務商控制臺或文檔中給出的精確名字為準。部分服務商在 API 返回錯誤中會列出支持的模型名例如出現(xiàn)the supported api model names are ...這樣的提示時是服務端在告訴你當前賬號可用的模型標識直接復制返回內(nèi)容里的模型名即可不要自己補后綴或加空格。3.4 在畫布里驗證 API 節(jié)點新增完連接器后不要直接開始搭復雜畫布先建一個最小驗證項目新建空白畫布。添加一個文本輸入節(jié)點手動輸入一段短劇臺詞草稿。添加一個 AI 處理節(jié)點連接器選擇剛才新增的 API 連接器模型選擇目標模型。把文本輸入節(jié)點連接到 AI 處理節(jié)點提示詞模板寫成“請把下面的臺詞改得更口語化保留人物性格{}”。運行節(jié)點查看輸出。如果輸出正常說明 API 連接器已經(jīng)打通。此時可以把提示詞模板中的內(nèi)容換成真正的分鏡描述驗證長文本處理效果。如果第一次調(diào)用失敗先看錯誤信息尤其是 HTTP 狀態(tài)碼401 一般表示 API Key、Token 不匹配或已失效。400 通常表示請求參數(shù)有問題最常見的是模型名錯誤或上下文超出長度。404 通常表示 Base URL 拼接錯誤路徑與真實接口不匹配。429 表示觸發(fā)了速率限制需要降低并發(fā)或等待配額恢復。注意不要把 API 返回的“400 上下文長度超限”當成普通報錯直接忽略。短劇分鏡文本往往很長一旦單次輸入超過模型窗口最直接的方法不是硬拆而是按場景、按鏡頭重新組織輸入塊或者換用上下文更長的模型。3.5 API 模式最容易踩的三個坑第一個坑是公網(wǎng) API 請求里的敏感內(nèi)容。劇本、分鏡、人物關系在傳輸過程中會到達服務商機房即使只用于調(diào)試也可能被服務商按協(xié)議留存。建議在接入 API 前把未公開的項目文件切到本地模式處理只把不涉及核心創(chuàng)意的通用潤色任務發(fā)送到遠程 API。第二個坑是直接使用訂閱網(wǎng)頁版的 Cookie 或臨時 Token 作為 API Key。網(wǎng)頁版和 API 版的鑒權(quán)體系往往不通用。如果服務商要求獨立創(chuàng)建 API Key就按文檔創(chuàng)建不要嘗試從瀏覽器里復制請求頭仿造。第三個坑是模型名被寫錯。大模型供應商經(jīng)常更新模型標識舊版模型名可能下線新版模型名要重新申請或開通。如果畫布某一天突然報模型不可用先去服務商控制臺確認模型名是否已經(jīng)變更確認連接器里填的是新模型名。4. 本地模型加載讓劇本和分鏡素材留在工作室內(nèi)部4.1 什么時候應該用本地模式本地模式適合四類情況劇本還未定稿不想讓外部服務提前接觸上下文。團隊希望通過大量低成本調(diào)用做文案批量改寫。工作室所在環(huán)境的網(wǎng)絡不穩(wěn)定遠程 API 時延波動大。模型服務商不提供某些能力需要使用開源模型做實驗。本地模式的成本看起來是“免費調(diào)用”但實際成本是硬件和維護。運行一個 7B 到 14B 參數(shù)的開源模型至少需要 16GB 到 32GB 內(nèi)存或?qū)@存。沒有 GPU 的機器也能運行小模型但速度會明顯下降。實際項目中不建議追求在辦公筆記本上跑大模型可以把本地模型服務裝在一臺專用機器上所有成員通過內(nèi)網(wǎng)訪問。4.2 用 Ollama 拉取模型并注冊到 JaceCanvasOllama 是配置本地模式最快捷的路徑之一。先選擇一個模型并下載ollama pull qwen2.5:7b上面的模型名只是示例。不同時間點的可用模型會變化實際執(zhí)行前先在 Ollama 模型庫確認完整名稱和你需要的量化版本。拉取完成后確認服務處于運行狀態(tài)curl http://127.0.0.1:11434/api/tags返回 JSON 包含models數(shù)組時說明服務可用。接下來回到 JaceCanvas 連接中心新增本地連接器配置如下Base URLhttp://127.0.0.1:11434/v1API Keyollama部分兼容實現(xiàn)只需要占位不需要真實鑒權(quán)模型名與ollama list輸出的名稱保持一致這里使用/v1是因為 Ollama 額外提供 OpenAI 兼容接口。JaceCanvas 這類連接器通常按照 OpenAI 協(xié)議拼請求因此本地地址也要指向兼容端點而不是直接填根地址。拉取模型后需要真正臨時“變成”某個模型。如果 Ollama 已加載直接請求即可。如果模型在第一次請求時才開始加載會明顯等待更長時間。建議在正式使用前先運行一次節(jié)點讓模型加載到內(nèi)存再進入批量處理。4.3 用 LM Studio 作為桌面臨時替代方案如果工作室成員需要在沒有 Ollama 的機器上快速驗證本地模型可以使用 LM Studio。它提供圖形界面先加載模型文件再在 Local Server 面板啟動本地 API 服務。啟動后復制服務地址通常是http://127.0.0.1:1234/v1把該地址填入 JaceCanvas 本地連接器即可。LM Studio 的主要作用是降低換模型成本。你可以在界面中直接切換不同模型文件不需要頻繁修改連接器配置因為端口和協(xié)議保持不變。切換模型后記得確認當前加載的是哪一個否則會出現(xiàn)“連接成功但輸出內(nèi)容風格與預期模型不符”的問題。4.4 本地模式最容易出的四個問題本地模式的排錯鏈路比 API 模式更偏環(huán)境。常見現(xiàn)象和原因如下問題現(xiàn)象常見原因檢查方式處理方式連接成功但提示模型不存在填寫的模型名與本地模型實際名稱不一致執(zhí)行ollama list查看精確名稱使用列表里的完整名稱包括版本號標簽請求后快速報上下文長度超限Ollama 默認上下文字段小于模型可支持值查看服務端啟動日志或模型加載信息通過 Modelfile 或 API 參數(shù)設置num_ctx第一次請求等了很久模型沒有預加載請求時才加載觀察運行節(jié)點前的系統(tǒng)資源占用先跑一次預熱請求再進入正式流程畫布內(nèi)報連接拒絕Ollama 服務未啟動或監(jiān)聽地址不對檢查curl http://127.0.0.1:11434/api/tags啟動 Ollama 或設置OLLAMA_HOST0.0.0.0本地模型“無法訪問”這個問題還要區(qū)分是本機訪問還是局域網(wǎng)訪問。工作室其他電腦要通過http://192.168.x.x:11434訪問時需滿足三個條件Ollama 服務監(jiān)聽在0.0.0.0而不是默認的127.0.0.1。防火墻允許對應端口訪問。JaceCanvas 連接器里填的是服務機器的局域網(wǎng) IP而不是127.0.0.1。如果已經(jīng)配置OLLAMA_HOST0.0.0.0仍然外部訪問失敗優(yōu)先檢查防火墻和網(wǎng)絡連通性不要反復修改連接器參數(shù)。4.5 本地模式的越權(quán)風險本地服務監(jiān)聽在局域網(wǎng)后工作室的每臺電腦都能直接調(diào)用。這意味著任何能訪問該端口的人都可能消耗 GPU 資源。建議做好最小防護只在可信內(nèi)網(wǎng)開放不要映射到公網(wǎng)。如果路由器或交換機支持訪問控制配置只允許工作室網(wǎng)段訪問。定期查看本地服務日志確認是否有異常調(diào)用來源。如果本地模型需要承載大量成員請求建議在 JaceCanvas Server 后面統(tǒng)一接入而不是讓每臺客戶端直連 GPU 機器。5. 服務器模式把 JaceCanvas 變成團隊共享工作臺5.1 為什么短劇工作室需要服務器模式API 模式解決“模型從哪來”本地模式解決“數(shù)據(jù)不出門”服務器模式解決的是“多人如何圍繞同一個創(chuàng)作項目協(xié)作”。沒有服務器模式時工作室團隊往往這樣工作編劇本地安裝一套 JaceCanvas。美術(shù)又裝一套素材靠網(wǎng)盤傳遞。分鏡腳本改了幾版后誰也說不清哪個是最終版。服務器模式通過部署一個 JaceCanvas Server讓所有成員通過客戶端連接到同一臺服務器。畫布數(shù)據(jù)、素材文件、模型調(diào)用記錄都集中在服務器上客戶端只負責編輯和展示。這個架構(gòu)最直接的好處是項目文件不再依賴個人電腦成員更換設備后重新登錄即可繼續(xù)工作。5.2 服務器模式的基礎拓撲服務器模式的邏輯鏈路如下成員 A 客戶端 成員 B 客戶端 成員 C 客戶端 | v JaceCanvas Server畫布數(shù)據(jù)、素材文件、權(quán)限、模型轉(zhuǎn)發(fā) | ------------------------------- | | | API 連接器 本地模型服務 素材存儲目錄客戶端不直接連接模型服務商而是把 AI 節(jié)點運行請求提交給 JaceCanvas Server。JaceCanvas Server 讀取連接器配置再決定請求轉(zhuǎn)發(fā)到哪個后端。這樣做的好處是 API Key 不需要分發(fā)到每個成員電腦上所有密鑰集中在服務器端方便回收和更換。5.3 使用容器方式部署 JaceCanvas Server具體安裝方式以 JaceCanvas 服務端安裝包或鏡像說明為準。本文用一個 Docker Compose 示意幫助理解需要關注的數(shù)據(jù)目錄、端口和環(huán)境變量services: jacecanvas-server: image: your-registry/jacecanvas-server:latest container_name: jacecanvas-server restart: unless-stopped ports: - 8080:8080 volumes: - ./data:/data - ./logs:/logs environment: - JACECANVAS_DATA_DIR/data - JACECANVAS_PUBLIC_URLhttps://canvas.example.com - JACECANVAS_DISABLE_REGISTERfalseJACECANVAS_DATA_DIR用于指定素材和項目數(shù)據(jù)的位置生產(chǎn)環(huán)境必須掛載到宿主機持久化目錄否則容器重建后數(shù)據(jù)會丟失。JACECANVAS_PUBLIC_URL是客戶端訪問服務端的公開地址配置反代后要改成真實域名。JACECANVAS_DISABLE_REGISTER表示是否允許自助注冊工作室內(nèi)部建議開啟邀請或管理員創(chuàng)建賬號。鏡像名稱和變量名是示例具體以官方文檔為準。部署前先確認端口 8080 沒有被占用并保證宿主機磁盤空間足夠存放分鏡素材和歷史項目數(shù)據(jù)。部署完成后在瀏覽器訪問服務器的健康檢查或登錄頁面。如果頁面能正常返回說明服務端基礎功能已經(jīng)起來。隨后在客戶端中新增“服務器連接”填寫地址https://canvas.example.com或內(nèi)網(wǎng)地址http://192.168.x.x:8080使用服務器管理員創(chuàng)建的賬號登錄。5.4 用 Nginx 為 JaceCanvas Server 增加 HTTPS生產(chǎn)環(huán)境不要直接暴露 HTTP 端口。建議用 Nginx 做反向代理把客戶端流量加密到 HTTPS再轉(zhuǎn)發(fā)到 JaceCanvas Server。一個最基本的 Nginx 配置如下server { listen 443 ssl; server_name canvas.example.com; ssl_certificate /etc/nginx/ssl/canvas.example.com.pem; ssl_certificate_key /etc/nginx/ssl/canvas.example.com.key; client_max_body_size 1024m; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }client_max_body_size要調(diào)大因為短劇畫布中的分鏡圖片和視頻片段體積會明顯大于普通網(wǎng)頁資源。如果不調(diào)大超過默認 1MB 的素材上傳會直接返回 413。HTTPS 配置完成后客戶端中的服務器地址必須改成https://開頭。否則一部分客戶端可能上報“連接不是私密連接”或“請求被阻止”。5.5 服務器模式上線前的安全底線服務器模式集中了項目數(shù)據(jù)和模型密鑰上線前至少完成六件事修改服務端默認管理員密碼。為每個成員創(chuàng)建獨立賬號按角色控制讀寫權(quán)限。關閉公網(wǎng)自助注冊成員賬號由管理員創(chuàng)建。配置數(shù)據(jù)目錄自動備份至少每天備份一次。檢查日志目錄是否記錄關鍵操作例如素材刪除和模型調(diào)用失敗。設置服務器時間同步避免 Token 校驗因時間偏差失效。另外要區(qū)分開發(fā)環(huán)境和生產(chǎn)環(huán)境。開發(fā)環(huán)境為了省事可能直接允許所有客戶端訪問也不開 HTTPS。生產(chǎn)環(huán)境必須按上述底線執(zhí)行否則一旦服務器被掃描到數(shù)據(jù)和模型 Key 會成為首要攻擊目標。6. 短劇工作室落地從單人畫布到多人生產(chǎn)6.1 按角色拆分項目視圖短劇工作室里的角色不是對稱的。編劇關注劇本、臺詞和人物弧光美術(shù)關注角色設定圖像和參考圖剪輯關注分鏡順序和片段銜接。服務器模式下項目應該按角色拆分目錄或協(xié)作空間。建議初始目錄結(jié)構(gòu)如下項目名稱/ ├── 01-scripts/ # 劇本、分集大綱 │ ├── sitcom-01.md │ └── sitcom-02.md ├── 02-characters/ # 人物小傳、角色設定圖 │ ├── male-lead.png │ └── female-lead.png ├── 03-storyboards/ # 分鏡草稿與鏡頭順序 │ └── episode-01/ ├── 04-assets/ # 美術(shù)素材、參考圖、BGM ├── 05-exports/ # 成片、宣傳物料 └── 06-templates/ # 常用提示詞模板共享給全員這個結(jié)構(gòu)不是強制標準但能避免素材和腳本混在一個目錄里。服務器模式下載或打開項目時客戶端會按此結(jié)構(gòu)同步。6.2 最小工作流從劇本段落生成分鏡提示詞下面用一個最小工作流說明 API、本地、服務器如何協(xié)同步驟如下步驟操作內(nèi)容使用模式說明1導入劇本段落服務器編劇把最新稿上傳到01-scripts2調(diào)用長文本模型拆分鏡頭API用外部大模型理解劇情生成鏡頭序號和畫面描述3生成角色一致性描述本地角色資料只在本地處理不發(fā)給外部服務4將分鏡畫布同步到服務器服務器客戶端保存后服務器開始統(tǒng)一存儲5成員各自動態(tài)預覽服務器美術(shù)、剪輯按需打開畫布不互相覆蓋實際畫布操作中差異主要在節(jié)點提示詞上。劇本拆鏡頭節(jié)點可以把提示詞設計為你是一個短劇分鏡師。請根據(jù)下面的劇情段落生成 5 個鏡頭。 每個鏡頭包含場景、景別、人物動作、臺詞、畫面提示詞。 要求不要添加原文不存在的情節(jié)。 劇情段落{script}{script}是 JaceCanvas 畫布節(jié)點從上游內(nèi)容節(jié)點讀取的變量。畫布節(jié)點運行時會把上游文本替換進提示詞模板然后請求對應連接器。6.3 素材與腳本版本管理短劇項目迭代很快。一天可能改三版劇本角色發(fā)型或服裝也會頻繁調(diào)整。服務器模式集中保存的是“當前最新版本”但歷史版本同樣重要。建議養(yǎng)成以下習慣修改重要劇本前先復制為帶日期的新文件。素材文件用語義化命名例如ep01-scene03-morning-v3.png。刪除素材前先放到“待刪除”目錄觀察一段時間不要直接清空。定期在服務器端做一次項目快照并記錄版本說明。JaceCanvas Server 如果自帶版本歷史功能盡量啟用。如果正式版還沒有提供只能通過外部備份機制彌補。此時目錄結(jié)構(gòu)要足夠規(guī)范否則恢復后找不到哪個節(jié)點對應哪個素材。6.4 畫布分享與交接提示畫布是 JaceCanvas 的最小工作單元。交接畫布時不要把整個服務器目錄發(fā)給新成員而是讓他們直接通過服務器打開項目。打開后先檢查右側(cè)連接器列表是否可以全部解析。如果發(fā)現(xiàn)某些節(jié)點綁定的連接器沒有同步到這個賬號節(jié)點會顯示為不可用狀態(tài)。為了讓交接順暢建議在團隊內(nèi)部約定連接器命名的全局規(guī)范連接器名稱實際用途后端類型api-strong-text長文本高質(zhì)量生成外部 APIapi-image-draft畫面草稿快速出圖外部圖像 APIlocal-char-secret角色資料保密處理本機 Ollamalocal-audio-subtitle字幕文案批量潤色本機 Ollamaserver-render團隊共用渲染服務JaceCanvas Server每個 JaceCanvas 客戶端都配置相同名稱的連接器后畫布從一臺電腦遷移到另一臺電腦時節(jié)點不需要重新選擇連接器。如果其他成員沒有配置同名連接器畫布會提示缺少連接器這種問題在實際協(xié)作中最常見。7. 三端聯(lián)調(diào)排錯按鏈路逐層定位問題7.1 先判斷問題屬于哪一層三端打通后增加了排錯復雜度。同一個節(jié)點運行失敗可能是客戶端配置問題、連接器參數(shù)問題、網(wǎng)絡問題、模型服務問題或服務器賬號問題。不要直接在畫布里反復點運行建議按層排查。故障層典型現(xiàn)象關鍵排查對象客戶端配置層節(jié)點沒有輸出、節(jié)點一直轉(zhuǎn)圈畫布節(jié)點輸入、提示詞模板、變量引用連接器配置層請求返回 404、401、400Base URL、API Key、模型名網(wǎng)絡鏈路層超時、連接拒絕、SSL 錯誤內(nèi)網(wǎng)連通性、防火墻、HTTPS 證書模型服務層上下文長度錯誤、模型無響應模型窗口、顯存、服務端日志賬號權(quán)限層登錄失敗、節(jié)點無權(quán)執(zhí)行Token、成員角色、管理員配置定位故障時建議先打開 JaceCanvas 的日志面板或?qū)С鋈罩疚募业阶罱淮问≌埱蟮腻e誤堆棧。不要憑界面上的“運行失敗”四個字猜原因日志中的 HTTP 狀態(tài)碼和錯誤文本比界面提示可靠得多。7.2 按五步鏈路逐層檢查第一步檢查輸入端。將 AI 處理節(jié)點上游暫時改為固定文本直接手動輸入一小段內(nèi)容。如果固定文本能運行、真實素材不能運行原因大概率在素材內(nèi)容或上游節(jié)點輸出結(jié)構(gòu)例如輸入太長或字段為空。第二步檢查連接器端點。先在命令行用 curl 手動請求服務端接口排除 JaceCanvas 自身因素。例如對于本地 Ollama 服務curl http://127.0.0.1:11434/api/tags對于 API 連接器可以用服務商提供的接口示例測試。如果 curl 能通、JaceCanvas 不能通重點檢查連接器字段是否復制完整。第三步檢查鑒權(quán)信息。登錄失敗時不要立刻懷疑服務器配置錯誤。先確認賬號狀態(tài)、Token 是否過期、服務器與客戶端時間是否偏差過大。時間不同步會導致基于時間的 Token 校驗失敗。第四步檢查模型名和上下文。當服務端返回類似the supported api model names are ...的信息時說明當前賬號支持列表中沒有你填寫的模型名。復制服務端返回的準確模型名重新配置。如果錯誤是上下文長度超限需要減少單次輸入或者換更大窗口的模型。第五步檢查服務器端日志。使用服務器模式時錯誤日志主要看 JaceCanvas Server 所在機器的日志?？蛻舳酥回撠燂@示真正的鑒權(quán)端口映射、數(shù)據(jù)讀寫和模型轉(zhuǎn)發(fā)都在服務端完成。如果服務端日志里連請求都沒到說明問題在網(wǎng)絡鏈路或 Nginx 配置。7.3 快速排錯表下面整理了三端聯(lián)調(diào)中最高頻的幾類問題可以直接對照處理問題現(xiàn)象常見原因定位方式處理建議401 login failed或類似提示Token 失效、賬號未啟用、時間偏差檢查賬號狀態(tài)和服務器時間重新生成 Token或同步服務器時間404請求地址不存在Base URL 填寫了完整接口路徑curl 對比真實接口地址在連接器只填寫協(xié)議、域名和版本前綴400 context length輸入 Token 數(shù)加上輸出限制超過模型窗口查看錯誤消息中的最大窗口數(shù)字裁剪輸入塊、增大上下文或減少輸出限制模型不存在模型名與遠端不一致查看服務商返回的支持模型列表復制返回信息中的準確名稱本地模型連接拒絕Ollama 未啟動或監(jiān)聽地址不對本機執(zhí)行 curl api/tags啟動 Ollama或設置OLLAMA_HOST0.0.0.0局域網(wǎng)電腦訪問不了本地模型防火墻攔截、填了 127.0.0.1在另一臺電腦 ping 服務機器填服務機內(nèi)網(wǎng) IP放行端口服務器模式上傳素材失敗Nginx 請求體積限制過小查看是否返回 413調(diào)大client_max_body_size畫布運行成功但輸出為空提示詞模板引用了空變量檢查上游節(jié)點是否真正輸出文本先固定輸入文本驗證節(jié)點本身7.4 故障排查的優(yōu)先級建議按經(jīng)驗排序先看輸入內(nèi)容是否正確因為節(jié)點問題常常被誤判為模型問題。再確認模型名稱這是三端配置中錯誤率最高的字段。接著檢查上下文長度短劇分鏡經(jīng)常把大量文本塞進同一個節(jié)點。然后排查網(wǎng)絡和端口本地部署最容易在監(jiān)聽地址上出錯。最后看賬號權(quán)限和服務端日志服務器模式才需要深入這一層。不要一上來就懷疑工具 Bug。大多數(shù)失敗在低層配置檢查中就能解決。8. 生產(chǎn)落地建議把最容易踩的坑提前堵住8.1 API Key 和連接器配置必須集中管理服務器模式最大的優(yōu)勢就是能把密鑰從客戶端收回來?？蛻舳顺蓡T不需要填寫任何真實 API Key所有密鑰只存在于 JaceCanvas Server 的配置里。如果當前使用桌面版點對點協(xié)作也要盡量通過環(huán)境變量或系統(tǒng)密鑰管理工具引用密鑰不要把密鑰直接寫在畫布項目文件中。項目文件在團隊中傳播一次密鑰就泄露一次。8.2 按內(nèi)容類型建立模型路由不是所有任務都要用最貴、最大的模型。短劇項目中常見任務和推薦模式可以這樣規(guī)劃任務類型推薦模式考慮因素劇本大綱、劇情走向建議外部 API長上下文、綜合能力較強臺詞潤色、對白口語化本地模型任務相對簡單本地模型成本低角色設定、人物關系梳理本地模型核心 IP避免外發(fā)分鏡畫面提示詞生成API 或本地均可需要多版本對比時用 API批量字幕文案生成本地模型量大、重復、敏感詞檢查可以離線做最終合成前的統(tǒng)一渲染JaceCanvas Server需要多人查看和確認歷史版本模型路由不是寫死規(guī)則。畫布中的每一個 AI 處理節(jié)點可以在不同連接器之間切換。建議在模板里建立多個同名提示詞節(jié)點讓成員在同一張畫布中觀察不同模型輸出而不是反復填寫提示詞。8.3 發(fā)布前檢查清單一個短劇項目在交付前建議按下面的清單檢查一遍檢查項說明素材版權(quán)確認背景音樂、圖片、字體是否獲得商用授權(quán)角色肖像合規(guī)生成內(nèi)容中涉及真實人物或特定形象時進行人工確認文本脫敏確認未公開劇本在 API 模式中發(fā)送前已去除身份信息模型輸出審核對 AI 一鍵生成的分鏡、臺詞、標題做逐條人工審核項目備份確認 JaceCanvas Server 數(shù)據(jù)目錄完成最近一次快照