Skip to content

用量與計費

對話使用已登入使用者的 HarperHarbor credits。獲得授權的應用程式可以代使用者發起對話,但不會取得或保管使用者的餘額。

GET /open/v1/models 公布各模型的費率,輸入、快取輸入與輸出分別計價。服務依模型回報的 token 用量計算最終費用,完成一則回覆至少收取 1 credit。

服務會在生成前,依輸入與輸出上限預留足夠的 credits,因此可用餘額可能需要高於最終費用;結算時會釋放未使用的預留額度。

費用依模型的實際用量計算。回覆遭安全攔截、模型因內容而拒答、回覆達到輸出上限,或使用者按下停止,只要模型已產生用量,就會照用量扣款;即使畫面沒有顯示回覆文字,也可能產生費用。

平台自身錯誤不收費,包含部署造成的中斷;服務錯誤若沒有產生模型用量,也不收費。每次操作只結算一次,未使用的預留額度會釋放;使用相同且內容不變的 clientOperationId 重送,不會重複扣款。

餘額不足以預留時,會收到 402 insufficient_credits。應用程式可引導使用者到帳號餘額查看可用 credits。

GET /open/v1/conversation/operations/{operationId} 提供操作結果,請合併查看操作狀態、settled 與 chargeCredits;帳號餘額與帳務明細則提供對應紀錄。應用程式不應以自行估算的 token 數量計算或承諾最終費用。

credits 方案與目前開放的購買方式,請見方案價格。

Agent 準備過程會在每次呼叫模型前預留 credits,需要時追加預留額度,並在每次執行結束後,彙總模型回報的輸入、輸出、快取讀取與快取寫入用量,一次結算。Agent 執行依 token 計價,即使該模型的一般呼叫採固定價格也是如此;模型目錄的預估值代表單輪範圍,不是多次呼叫的 Agent 執行費用上限。

使用者停止或模型服務出錯前,已完成的模型用量仍會計費;平台自身錯誤不收費。接續已儲存的準備進度,只收取新增的模型用量;重新連線或重播同一次操作,不會重複扣款。自動記憶準備另外計費與結算。

帳務明細會將這類費用標示為 Agent 模式,並另列實際使用的模型;最終費用以操作結果的 settled 與 chargeCredits 為準。