收費㧯點數
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 个收費入口，你做得在該位換卡㧯看發票。
假使翻譯㧯英文參考文件無共樣，就以英文參考文件為準。