Pagsingil at mga credit

Bersyon ng API 2026-10-virile-dragon

Dalawang paraan ng pagbabayad

Sinisingil ang isang client sa isa sa dalawang paraan, at hindi na nababago ang mode nito kapag ginawa ito. Ang isang allowance client ay gumagamit ng allowance ng plan ng may-ari nito, ang parehong allowance ng iyong mga app, at hindi kailanman naniningil sa card. Ang isang metered client ay hindi gumagamit ng allowance: bawat tawag nito ay nagkakahalaga ng mga credit, na sinisingil sa card ng iyong usage-billing subscription. Ang tawag na ginagawa ng isang app para sa ibang user, gamit ang token mula sa authorization code, ay laging gumagamit ng allowance ng user na iyon, anuman ang mode ng client.

Mga credit kada tawag

Ang tawag ng isang metered client ay nagkakahalaga ng mga credit na katumbas ng scope nito, na nakalista sa talahanayan sa ibaba; ang scope na katumbas ng 0 credit ay walang bayad. Ang units na iniuulat ng GET /v1/usage ay nako-convert sa credit gamit ang mga bigat na ito. Sinisingil ang isang tawag ayon sa mga bigat na umiiral sa araw na ginawa ito, anuman ang bersyong nakakabit sa client: itinatala ng talahanayan sa reference ng mas lumang bersyon ang mga bigat noong inilathala ang bersyong iyon, hindi ang halaga ng isang tawag ngayon.

Mga scope
`vocab:generate`	Gumawa ng mga listahan ng bokabularyo.	Gumawa ng listahan ng bokabularyo
`lesson_plans:read`	Basahin ang iyong mga lesson plan at muling kumonekta sa kanilang progreso.	Kunin ang isang lesson plan Muling kumonekta sa isang lesson plan
`lesson_plans:write`	Gumawa ng mga lesson plan.	Gumawa ng lesson plan
`tutor:converse`	Makipag-usap sa tutor. Nangangailangan ng bayad na plan.	Magpadala ng palitan sa tutor
`usage:read`	Tingnan ang natitira mong allowance, o ang paggamit ngayong buwan ng isang `metered` client.	Kunin ang natitira mong allowance
`events:read`	Basahin ang mga event tungkol sa iyong account, at magrehistro ng mga endpoint na tatanggap sa mga ito.	Ilista ang mga event I-stream ang mga event
`events:write`	Magpadala ng mga event mula sa iyong laro o integration papunta sa Lingara.	Magpadala ng event
`embed:mint`	Gumawa ng mga panandaliang token para sa mga manlalaro ng iyong laro o site, at magbura ng mga manlalaro. Para lang sa mga client na sinisingil ayon sa paggamit.	Gumawa ng token para sa manlalaro Magbura ng manlalaro I-unlink ang isang manlalaro mula sa kanilang Lingara account
`embed:play`	Kumilos para sa isang manlalaro: ipadala ang kanilang mga resulta sa pagsasanay at makipag-usap sa kanila bilang NPC.	I-link ang isang manlalaro sa kanilang Lingara account Magpadala ng linya sa isang NPC

Ang presyo

Ang isang credit ay nagkakahalaga ng US$0.004. Buwanang sinisingil ang paggamit, para sa bawat buwan sa kalendaryo na nagsisimula sa ika-1 (UTC), sa card ng iyong usage-billing subscription.

Mga limitasyon sa paggastos

May buwanang limitasyon sa credit ang iyong account, at maaaring magkaroon ang bawat metered client ng sarili nitong mas mababang limitasyon; itakda ang dalawa sa pahinang Mga integration. Kapag naabot na ng client o ng iyong account ang limitasyon nito, tinatanggihan ang mga tawag ng client gamit ang 402 at ang code na spend_cap_reached hanggang magsimula ang susunod na buwan o itaas ang limitasyon.

Kapag hindi aktibo ang usage billing

Tinatanggihan ang mga tawag ng isang metered client gamit ang 402 at ang code na metered_billing_inactive habang hindi aktibo ang usage billing: bago ito i-set up, habang may overdue na bayad, at matapos itong kanselahin. I-set up, pamahalaan o kanselahin ang usage billing sa pahinang Mga integration, sa app.getlingara.com/admin. Kapag pinamahalaan ito, bubukas ang billing portal ng Stripe, kung saan mapapalitan mo ang iyong card at mababasa ang iyong mga invoice.

Kung magkaiba ang isang salin at ang sangguniang Ingles, ang sangguniang Ingles ang tama.