收費同點數
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 嘅收費入口網站，你可以喺度換卡同睇發票。
如果譯本同英文參考文件有出入，以英文參考文件為準。