計費與點數
API 版本 2026-10-virile-dragon
兩種付費方式
用戶端有兩種計費方式，其模式在建立時就已固定。allowance 用戶端消耗其擁有者的方案額度，與你的應用程式是同一份額度，從不向信用卡收費。metered 用戶端不消耗額度：它的每次呼叫都消耗點數，向你按用量計費訂閱綁定的信用卡收費。應用程式代表其他使用者、以透過授權碼取得的權杖所發出的呼叫，無論用戶端採用哪種模式，一律消耗該使用者的額度。
每次呼叫的點數
metered 用戶端的一次呼叫消耗其權限範圍對應的點數，列於下表；對應 0 點的權限範圍不收費。GET /v1/usage 回報的 units 按這些權重換算為點數。無論用戶端固定在哪個版本，呼叫都按發出當天生效的權重計費：舊版本參考文件中的表格記錄的是該版本發布時的權重，而不是一次呼叫今天的費用。
vocab:generate | 產生詞彙表。 | 產生詞彙表 |
lesson_plans:read | 讀取你的課程計畫並重新連線到其進度。 | 取得課程計畫重新連線到課程計畫 |
lesson_plans:write | 建立課程計畫。 | 建立課程計畫 |
tutor:converse | 與家教對話。需要付費方案。 | 傳送一輪家教對話 |
usage:read | 查看你的剩餘額度，或 `metered` 用戶端本月的用量。 | 取得剩餘額度 |
events:read | 讀取與你的帳戶相關的事件，並註冊接收這些事件的端點。 | 列出事件事件串流 |
events:write | 從你的遊戲或整合向 Lingara 傳送事件。 | 傳送事件 |
embed:mint | 為你的遊戲或網站的玩家簽發短期權杖，並刪除玩家。僅限按用量計費的用戶端。 | 為玩家簽發權杖刪除玩家解除玩家與其 Lingara 帳戶的連結 |
embed:play | 代表玩家行事：傳送其練習結果，並與其進行 NPC 對話。 | 將玩家連結到其 Lingara 帳戶向 NPC 傳送一句話 |
價格
每個點數 US$0.004。用量按月計費，每個日曆月從 1 日（UTC）開始計算，向你按用量計費訂閱綁定的信用卡收費。
支出上限
你的帳戶有一個以點數計的每月上限，每個 metered 用戶端還可以設定自己更低的上限；兩者都在整合頁面上設定。一旦用戶端或你的帳戶達到上限，該用戶端的呼叫會遭到拒絕，並傳回 402 與代碼 spend_cap_reached，直到下個月開始或上限調高為止。
按用量計費未啟用時
按用量計費未啟用時，metered 用戶端的呼叫會遭到拒絕，並傳回 402 與代碼 metered_billing_inactive：包括設定之前、付款逾期期間以及取消之後。請在整合頁面（網址為 app.getlingara.com/admin）上設定、管理或取消按用量計費。管理會開啟 Stripe 的帳單入口網站，你可以在其中更換信用卡並查看發票。
如譯文與英文參考文件有出入，以英文參考文件為準。