幫助與參考
使用指南
更新日誌
使用手冊的結構調整與介面說明變更記錄
更新日誌
本頁記錄使用手冊文件的結構調整與介面說明變更，方便已經接入的開發者對照檢查。
文件只描述目前有效的行為；如與你的歷史實作不一致，請以本手冊和 GET /v1/models 的即時結果為準。
本次更新（文件規範化）
導覽結構
使用手冊改為依使用路徑組織，共六個分區：
| 分區 | 內容 |
|---|---|
| 快速開始 | 快速開始、平台功能指南、模型廣場與計費、常用工具整合 |
| 平台總覽 | 四個平台的定位、功能與常見問題 |
| API 接入 | 認證規範、介面總覽、文字、圖片、影片、音訊、錯誤碼 |
| 素材庫 | 素材庫指南、素材庫介面、人像流程、參考影片 |
| 網頁創作 | Creation 工作台與 Agent、影片生成與重試、常見問題 |
| 幫助與參考 | 常見問題彙整、計費與帳單、限流與配額、更新日誌、術語表 |
頂部標籤與側邊欄同步更新。所有原有位址保持不變，已分享給客戶的連結繼續有效。
新增內容
- 新增「幫助與參考」分區：常見問題彙整、計費與帳單、限流與配額、更新日誌、術語表；
- 新增文字轉語音介面的獨立說明頁；
- 補齊四個平台頁面的功能清單、典型工作流程與常見問題；
- Canvas 頁面補充節點類型、常用操作、快速鍵與完整創作流程範例；
- 文件索引補充音訊介面與平台總覽入口。
修正內容
- 修正 Canvas 頁面指向未發佈頁面的失效連結；
- 修正文件總入口的影片介面連結，改為直接前往建立任務頁面；
- 修正文件索引遺漏的音訊介面條目，與介面總覽保持一致。
概念釐清
以下行為在手冊中做了明確說明，接入時請特別注意：
| 主題 | 說明 |
|---|---|
| 完成時結算 | 非同步任務在完成時結算，提交只受理任務，不預先扣費 |
| 查詢不計費 | 查詢任務狀態不產生費用，只有建立任務才計費 |
| 不合併重複請求 | 相同參數重複提交會建立新任務並各自計費，平台不會自動合併 |
| 素材只需入庫一次 | 素材 ID 跨模型保持一致，切換模型只需修改 model 欄位 |
| 真人素材不可降級 | 切換到不支援真人素材的模型時不會自動改成一般參考圖 |
| 請求快照權限 | 請求內容與請求 JSON 僅管理員可見，一般使用者查詢時不會傳回該欄位 |
如何確認目前行為
文件描述的是設計行為，實際的模型可見範圍必須以即時結果為準：
curl "$LOCOPAL_BASE_URL/v1/models" \
-H "Authorization: Bearer $LOCOPAL_API_KEY"模型目錄會隨帳戶授權、接入位址和平台可用性變化。建議在服務啟動、使用者切換模型， 或收到「模型不可用」時重新查詢，不要寫死模型名稱。
相關文件
這一頁有幫助嗎？