常見問題彙整

本頁依主題彙整平台使用中的常見問題。每個條目提供原因和可執行的下一步；更細的介面層級排查見 錯誤碼與排查，創作工作台的問題見 網頁創作常見問題。

帳號與登入

為什麼開啟 Creation 又要求我登入？

LocoPal Ai 是唯一的身份來源。Creation 依賴 locopalai.com 下發的跨子網域工作階段 Cookie， 如果該 Cookie 失效或不存在，子平台會跳回統一登入頁。

先確認：開啟 LocoPal Ai 是否處於登入狀態。若它已登入而子平台仍顯示未登入， 請重新整理該子平台頁面；仍然無法解決時，在 LocoPal Ai 登出後重新登入一次。

換了電腦還需要另外登入 Creation 嗎？

不需要。在 LocoPal Ai 登入一次，Creation 會自動取得登入狀態。

修改密碼或登出會影響其他平台嗎？

會。登出、切換帳號、修改密碼都會讓 Creation 同步失效，這是同一套工作階段的正常行為。

API 金鑰

一把 Key 能呼叫所有介面嗎？

能。模型、圖片、影片、音訊和素材介面共用同一把 Key，不需要依介面分別建立。

為什麼這把 Key 看不到某個模型？

模型可見範圍由 Key 所屬的呼叫分組決定。用該 Key 請求 GET /v1/models 確認： 如果傳回的 data 中沒有該模型，表示它不在這個分組的授權範圍內。

傳回 "data": [] 是什麼意思？

表示目前 Key 所屬分組下沒有任何可用模型。先確認分組設定是否正確，仍有疑問時聯絡平台支援並提供 Key 名稱（不要提供完整 Key）。

Key 外洩了怎麼辦？

立即在主控台「API 金鑰」中停用該 Key（而不是等它自然到期），然後為業務建立新的 Key 並替換設定。 停用不影響帳號下的素材、任務和歷史記錄。

為什麼不能把 Key 寫在前端程式碼裡？

瀏覽器和行動裝置安裝檔中的任何內容都可能被擷取。Key 必須放在伺服器端環境變數或金鑰管理服務中， 由你的業務後端代為呼叫平台。

模型與呼叫

請求中的 model 該填什麼？

填 GET /v1/models 傳回的 data[].id，照原樣填寫。不要使用模型廣場頁面上顯示的顯示名稱。

提示「模型暫時無法使用」或「無可用通道」

表示目前時段無法路由到該模型，不代表 Key 有問題。先重新整理模型清單或改用同類模型； 持續無法使用時聯絡平台支援並提供請求 ID。

文字呼叫傳回空的 content，finish_reason 是 length

推理模型可能將 max_tokens 全部消耗在推理過程（completion_tokens_details.reasoning_tokens）上。 提高輸出上限，或改用非推理模型後重試。

圖片介面回報 unknown_parameter

部分圖片模型（例如 GPT Image 系列）不接受 response_format 欄位。移除該欄位後重試即可。 size、quality、response_format 的支援情況都以目前模型為準。

傳回的圖片 URL 打不開

圖片介面傳回的可能是短期位址，請儘快轉存到自己的儲存空間。需要長期重複使用的圖片應先入庫到素材庫， 再透過 asset://<asset_id> 引用。

影片任務

為什麼影片是非同步的？

影片生成耗時較長，平台以「建立任務 → 查詢結果」的方式處理。建立介面會傳回任務 ID， 再用查詢介面輪詢進度和結果。

提交後本機等待逾時，要重新建立嗎？

不要。 取得任務 ID 後即使本機逾時，也只能繼續查詢原任務。重新建立會產生重複任務和重複費用。

建立回應中沒有 progress，是失敗了嗎？

不是。建立回應只需依賴 id / task_id、status、model 和 created_at； object、progress 等欄位可能要到首次查詢才會出現，不能將它們當成建立成功的必要條件。

狀態是 failed，要怎麼查看原因？

讀取同一回應中的 error.code 和 error.message。影片終態失敗通常是 video_generation_failed， error.message 已是清理後的可讀原因，不要再解析其中的 JSON。

查詢時會重複計費嗎？

不會。查詢只讀取狀態，不產生費用。只有重新建立任務才會產生新的費用，這也是不要重複提交的原因。

素材與真人授權

需要為每個模型分別上傳素材嗎？

不需要。素材只需入庫一次，進入平台統一素材庫；凡是支援素材引用的模型都使用同一份素材， 素材 ID 保持不變，切換模型只需修改請求中的 model 欄位。

素材什麼時候才能使用？

data.asset.status 變為 Active 後才能穩定使用。顯示「上傳中」「處理中」時請保留並等待， 不要對同一筆失敗項目連續重複提交。

提交素材要用什麼圖片位址？

使用可從公網直接下載的 http(s) 位址，或依介面限制提交 data_url。 不要把瀏覽器本機檔案路徑當成介面參數。

真人素材可以用一般圖片代替嗎？

不能。 真人素材必須由本人用手機掃碼完成活體採集與授權。 主控台流程為「素材庫管理 → 新建分組 → 真人素材庫 → 產生 QR 碼 → 本人掃碼 → 已完成掃碼，開始同步」。

切換到不支援真人素材的模型會怎樣？

真人素材只在明確支援它的模型上生效。切換到不支援的模型時，平台不會自動將它降級成一般參考圖， 請改用虛擬素材或切回支援的模型。

素材會影響其他模型嗎？

入庫與模型無關。素材狀態變為可用後即可在任一支援素材引用的模型中使用，不需要等待模型端再次準備。 既有素材會在首次被引用時由平台準備一次。

計費與餘額

提交影片任務就會扣費嗎？

沒有。非同步任務在完成時結算，提交成功只受理任務，不會預先扣費。 提交前平台會驗證餘額或 Key 額度能否涵蓋本次預估，不足時直接傳回可讀提示，不會建立任務。

參數驗證失敗（400）會扣費嗎？

通常不會。400 表示請求未被受理，一般不會產生生成任務費用。

價格卡片上的價格就是最終扣費嗎？

不等於。價格卡片用於估算，實際扣費以請求實際使用量、所屬分組和伺服器端帳單記錄為準。 詳見計費與帳單。

覺得扣費異常，該如何核對？

使用任務 ID、請求識別碼、模型 ID 和時間範圍定位到具體記錄，再對照帳單明細。不要提供完整金鑰。

平台與創作工具

兩個平台是什麼關係？

LocoPal Ai 是核心，提供帳號、計費、模型、素材與任務記錄；Creation 是接入它的用戶端。 詳見平台總覽。

在 Creation 中生成的素材，API 能使用嗎？

能。兩者共用同一份素材庫，素材 ID 也相同。

重新整理頁面會重新生成或重複扣費嗎？

不會。重新整理只還原頁面狀態，不會重新建立任務，也不會重複計費。不要對仍在執行的任務重複提交。

仍然沒有解決

提交支援請求時請提供：發生時間、模型名稱、任務 ID 或請求 ID、HTTP 狀態（介面呼叫時）、 去識別化後的錯誤訊息，以及請求類型（文字 / 圖片 / 影片 / 音訊）。

不要提交：API keys、完整 Authorization 請求標頭、登入 Cookie、真實人像資料， 或帶簽章的完整素材位址。相關範圍見錯誤碼與排查。