收費佮點數
API 版本 2026-10-virile-dragon
兩種付錢的方式
用戶端的計費方式有兩種，伊的模式佇建立的時陣就固定矣。allowance 用戶端用伊擁有者方案的額度，佮你的應用程式是仝一份額度，永遠袂佇卡頂收費。metered 用戶端袂用著額度：伊的逐擺呼叫攏愛點數，對你照用量計費訂閱的卡收費。應用程式替別个用戶、用授權碼提著的權杖所做的呼叫，無論用戶端是佗一種模式，攏用彼个用戶的額度。
逐擺呼叫的點數
metered 用戶端逐擺呼叫愛偌濟點數，看伊的權限範圍值偌濟，列佇下跤的表格；值 0 點的權限範圍免錢。GET /v1/usage 報的 units 照這寡權重換算做點數。一擺呼叫照伊做的彼工有效的權重收費，無論用戶端固定佇佗一个版本：舊版本參考文件內底的表格記的是彼个版本發布的時陣的權重，毋是這馬一擺呼叫愛偌濟錢。
vocab:generate | 產生詞彙清單。 | 產生詞彙清單 |
lesson_plans:read | 讀取你的課程計畫，閣重新連著in的進度。 | 取得課程計畫重新連著課程計畫 |
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 的收費入口，你會當佇遐換卡佮看發票。
若是翻譯佮英文參考文件無仝，就以英文參考文件為準。