平台功能指南

本頁按日常使用順序介紹 LocoPal Ai 的主要功能。登入後只會看到目前帳戶的金鑰、任務、素材和帳單。

首頁與模型廣場

首頁和頂部產品入口提供主控台、使用手冊、模型廣場和 LocoPal Creation。模型廣場集中顯示模型名稱、能力、參數和計費詳情。

選擇模型時依次確認：

1. 模型能力與業務類型一致，例如影片任務選擇影片模型；
2. 模型 ID 出現在目前 API Key 的 /v1/models 回應中；
3. 請求參數屬於模型詳情顯示的支援範圍；
4. 預估價格符合預算，最終以實際帳單為準。

主控台概覽

主控台用於查看餘額、方案、呼叫量、消耗趨勢和近期記錄。統計資料用於定位高消耗模型和異常尖峰，帳單明細用於核對最終費用。

API 金鑰

API Key 是呼叫模型、圖片、影片、音訊和素材介面的唯一憑證，同一把 Key 在所有介面之間通用。建議按「生產服務」「測試環境」「客戶應用」分別建立，並設定清楚的名稱、額度和有效期限。

刪除或停用 Key 不會刪除該帳戶的素材、任務和歷史記錄，重新建立 Key 後仍可繼續使用原有素材。

使用日誌與任務日誌

使用日誌記錄同步呼叫，可依時間、API Key、模型、分組、請求識別碼和狀態篩選。任務日誌用於影片、音訊等非同步業務，建立任務後應保存任務 ID；等待時間變化不代表重新計費，只有重新建立任務才會產生新的任務身分。

任務日誌會顯示提交時間、任務 ID（含上游任務編號）、耗時、狀態、進度和詳情。任務成功後在「詳情」欄會出現「點擊預覽影片」，點擊即可在彈出視窗裡直接播放生成的影片，彈出視窗內可以複製播放位址，不需要先下載再查看。管理員在任務日誌中查看其他帳號的任務時同樣可以直接預覽。

日誌只顯示目前帳戶自己的記錄。

素材庫管理

素材庫是素材分組的集合，提供虛擬人物和真人素材兩個類別。

虛擬人物

1. 點擊「新建分組」，選擇「虛擬人像」，填寫分組名稱和說明（名稱和說明都可以留空，留空時平台會自動命名，例如「虛擬人像素材 09-11 21:05」）；
2. 在分組內點擊「上傳圖片」直接選擇本機圖片，或用「提交素材」填寫可公開存取的 http(s) 圖片位址；
3. 素材提交是非同步處理，狀態顯示為「可用」後即可穩定用於支援素材引用的模型；
4. 支援重新命名素材、重新整理狀態和刪除；刪除分組前需要先移走或刪除分組內的素材。

提交素材時「素材名稱」也可以留空，平台會依上傳檔案的檔名命名；需要改名時在素材清單裡重新命名即可。

真人素材

真人素材必須由本人完成手機端採集與授權：

1. 點擊「新建分組」，選擇「真人素材庫」；
2. 閱讀並勾選授權協議，產生 QR 碼；
3. 由真人本人用手機掃碼完成採集、授權和資料填寫；
4. 回到網頁點擊「已完成掃碼，開始同步」；
5. 頁面顯示真人分組和採集產生的素材，仍在處理時稍後重新整理。

真人分組與發起掃碼的目前帳戶綁定，其他帳戶不能解析或重複使用該工作階段。如果建立授權工作階段時提示暫不可用，請保留提示資訊並聯絡平台支援。

尋找與篩選

• 搜尋：分組清單和素材清單都支援依名稱或 ID 搜尋；
• 篩選：可依分組類型和所屬模型篩選，只看會用於某個模型的分組與素材；
• 所屬模型：清單裡只顯示第一個模型名稱和一個 +N 計數，滑鼠移到上面會列出這個分組或素材的全部所屬模型；
• 分頁：清單分頁載入，底部顯示總筆數，並可以選擇每頁顯示 10 / 20 / 50 / 100 筆（預設 10 筆）；
• 重新整理：重新讀取目前帳戶分組和素材的名稱、狀態、錯誤資訊與存取位址。

素材只需要入庫一次

不需要為每個模型分別建立分組或上傳素材。入庫時素材進入平台統一素材庫，凡支援素材引用的模型都直接使用同一份素材，素材 ID 保持不變，因此可以直接在模型之間重複使用，也不需要等待模型端同步。模型與素材庫的對應關係見素材庫介面。

在此之前的存量素材會在首次被某個模型引用時由平台準備一次，準備完成後與直接引用的素材行為一致。

逐庫核對（管理員）

管理員的素材庫管理頂部可以在「平台素材庫」和各個模型的素材庫之間切換：切到某個模型的素材庫後，可以唯讀地查看該庫裡的分組與素材（預設只顯示模型名稱），也可以在庫裡直接新建分組、提交素材，用於特殊準備和排查。庫裡的提交素材同樣支援直接上傳圖片，名稱留空會依檔名自動命名。

餘額、儲值與帳單

餘額頁用於儲值、查看方案或兌換權益。模型廣場提供預估價格，任務完成後的帳單提供最終結算。核對異常扣費時使用任務 ID、請求識別碼、模型 ID 和時間範圍，不要提供完整金鑰。

LocoPal Creation

• LocoPal Creation：用於直接創作的工作台，提供智慧模式、AI 繪圖、AI 影片、AI 音訊、短劇、作品、素材和提示詞等入口；

Creation 重用同一 LocoPal 帳戶與模型服務，生成結果、任務和素材依目前登入使用者隔離。

常見工作流程

API 接入

建立 API Key → 查詢模型 → 發起測試呼叫 → 在日誌核對 → 接入業務服務 → 設定逾時與錯誤處理。

多圖與參考影片

準備公網媒體或狀態為「可用」的素材 → 建立非同步影片任務 → 保存任務 ID → 查詢直到終態 → 下載或轉存結果。

真人影片

建立真人授權工作階段 → 本人掃碼採集 → 解析工作階段 → 查詢真人素材狀態 → 素材可用後提交支援真人素材庫的影片任務。