幫助與參考
使用指南
計費與帳單
計費方式、結算時點、餘額驗證與費用核對
計費與帳單
LocoPal 的餘額、方案、消費與帳單都集中在 LocoPal Ai 的帳戶中。Creation 不另行收費，它的消耗統一計入同一個帳戶。
計費方式
不同模型依不同方式計費，具體以模型廣場的詳細資料頁顯示為準。
| 計費方式 | 含義 | 常見於 |
|---|---|---|
| 按 Token | 依輸入與輸出 Token 分別計費，單位顯示為 1K 或 1M Token | 文字對話、多模態理解 |
| 快取輸入 / 快取寫入 | 僅支援提示詞快取的模型才會顯示 | 支援快取的文字模型 |
| 按次 | 每次成功請求依固定價格計費 | 部分圖片模型 |
| 按量 / 按時長 | 依解析度、時長或模型定義的計量單位計費 | 影片、音訊 |
影片模型（例如 doubao-seedance、seedance 系列）會顯示獨立的價格矩陣，
依「是否含影片輸入」和「輸出解析度」拆分。閱讀時先確定本次是否提交影片輸入，
再選擇需要的解析度：
- 只上傳文字或圖片參考 → 查看「不含影片輸入」欄；
- 提交影片作為輸入 → 查看「含影片輸入」欄；
- 不支援的組合會明確標註「不支援」；未顯示的級距不要依相鄰級距推測。
結算時點
這是最容易產生誤解的一點，請區分同步介面和非同步任務。
| 類型 | 結算方式 |
|---|---|
| 同步呼叫（文字、圖片、音訊） | 請求成功傳回後計入用量 |
| 非同步任務（影片） | 完成時結算：提交只受理任務，不預先扣費；任務完成後帳單中會出現一筆實際扣費記錄 |
非同步任務的關鍵行為：
- 提交前平台會驗證帳戶餘額（或目前 Key 的額度）能否涵蓋本次預估消耗； 不足時會直接傳回可讀提示，不會建立任務；
- 任務執行中不會產生中間扣費；
- 查詢任務狀態不產生費用，只有建立任務才計費；
- 失敗任務的計費依該模型與平台價格設定處理。
餘額與驗證
- 呼叫前平台會驗證餘額是否涵蓋預估消耗，不足時傳回提示而不是建立任務；
- 文字模型的預估依輸入長度估算，實際以回應中的
usage為準； - 圖片、影片等按次或按時長計費，預估與實際通常在模型支援範圍內一致；
- 建議在業務後端對餘額不足做前置判斷和友善提示，不要把餘額驗證完全交給平台傳回的錯誤。
在哪裡核對
| 想看什麼 | 去哪 |
|---|---|
| 餘額、儲值、方案、訂單 | LocoPal Ai 主控台「錢包」 |
| 每一次同步呼叫的明細（模型、Token、費用） | 「使用日誌」 |
| 非同步任務狀態、進度與成品 | 「任務日誌」 |
| 模型價格與計費方式 | 「模型廣場」 |
錢包提供儲值、方案與權益兌換；模型廣場提供估算價格；帳單提供最終結算。三者用途不同， 價格顯示不等於最終扣費。
核對異常扣費
依下列順序定位，不要憑感覺判斷：
- 確定時間範圍：先縮小到發生問題的那段時間；
- 找到任務或請求識別碼：非同步任務使用任務 ID，同步呼叫使用請求 ID；
- 確認模型：使用模型 ID（不是顯示名稱）確認是哪個模型產生的；
- 對照用量與單價：文字對照
usage的輸入輸出 Token；影片對照解析度、時長與輸入類型； - 檢查是否重複提交：非同步任務最常見的異常是多建立了一次任務，而不是單價錯誤。
完成上述定位後，再聯絡平台支援並提供這些資訊。不要提供完整金鑰。
控制消耗
- 依應用程式拆分 Key：生產服務、測試環境、客戶應用程式分別建立，便於定位消耗來源；
- 為 Key 設定額度與有效期限：限制異常消耗的影響範圍；
- 選對模型：同樣的任務使用更小的模型往往能顯著降低成本；
- 避免重複提交：非同步任務儲存任務 ID，以查詢而不是重新建立來追蹤進度；
- 及時轉存結果：圖片和影片的傳回位址可能是短期的，到期後需要重新生成。
常見誤解
| 誤解 | 事實 |
|---|---|
| 「提交影片任務就扣費了」 | 非同步任務在完成時結算，提交不預先扣費 |
| 「一直查詢會重複計費」 | 查詢不產生費用，重複建立才會 |
| 「價格卡片就是最終價格」 | 卡片用於估算，實際以帳單為準 |
| 「Creation 要另外儲值」 | 兩個平台共用同一個帳戶額度 |
| 「400 錯誤也扣費」 | 參數驗證失敗通常不產生生成任務費用 |
| 「換模型要重新上傳素材」 | 素材只需入庫一次，同一素材 ID 可跨模型重複使用 |
這一頁有幫助嗎？