Lingara Lingara Dokumentasi Panduan API Pustaka Aplikasi Bina Benam Apl web
Bahasa: Bahasa Melayu

Pengebilan dan kredit

Versi API 2026-10-virile-dragon

Dua cara untuk membayar

Klien dibilkan dengan salah satu daripada dua cara, dan modnya ditetapkan semasa ia dicipta. Klien allowance menggunakan kuota pelan pemiliknya, kuota yang sama dengan aplikasi anda, dan tidak pernah mengenakan caj pada kad. Klien metered tidak menggunakan kuota: setiap panggilannya memerlukan kredit, yang dicaj pada kad dalam langganan pengebilan bermeter anda. Panggilan yang dibuat oleh aplikasi bagi pihak pengguna lain, dengan token daripada kod kebenaran, sentiasa menggunakan kuota pengguna itu, tanpa mengira mod klien.

Kredit setiap panggilan

Satu panggilan klien metered memerlukan kredit sebanyak nilai skopnya, yang disenaraikan dalam jadual di bawah; skop yang bernilai 0 kredit adalah percuma. units yang dilaporkan oleh GET /v1/usage ditukar kepada kredit dengan pemberat ini. Panggilan dibilkan dengan pemberat yang berkuat kuasa pada hari ia dibuat, tanpa mengira versi yang disematkan pada klien: jadual dalam rujukan versi yang lebih lama merekodkan pemberat semasa versi itu diterbitkan, bukan kos sesuatu panggilan hari ini.

Skop
vocab:generate Jana senarai kosa kata. Jana senarai kosa kata
lesson_plans:read Baca rancangan pelajaran anda dan sambung semula kepada kemajuannya. Dapatkan rancangan pelajaranSambung semula kepada rancangan pelajaran
lesson_plans:write Cipta rancangan pelajaran. Cipta rancangan pelajaran
tutor:converse Bercakap dengan tutor. Memerlukan pelan berbayar. Hantar giliran tutor
usage:read Lihat baki kuota anda, atau penggunaan klien `metered` bulan ini. Dapatkan baki kuota anda
events:read Baca acara tentang akaun anda, dan daftarkan titik akhir yang menerimanya. Senaraikan peristiwaStrim peristiwa
events:write Hantar acara daripada permainan atau integrasi anda kepada Lingara. Hantar peristiwa
embed:mint Keluarkan token jangka pendek untuk pemain permainan atau laman anda, dan padam pemain. Klien berbayar mengikut penggunaan sahaja. Keluarkan token untuk pemainPadam pemainNyahpautkan pemain daripada akaun Lingara mereka
embed:play Bertindak bagi pihak pemain: hantar keputusan latihannya dan adakan perbualan NPC dengannya. Pautkan pemain kepada akaun Lingara merekaHantar satu ayat kepada NPC

Harga

Satu kredit berharga US$0.004. Penggunaan dibilkan setiap bulan, bagi setiap bulan kalendar yang bermula pada 1 haribulan (UTC), pada kad dalam langganan pengebilan bermeter anda.

Had perbelanjaan

Akaun anda mempunyai had bulanan dalam kredit, dan setiap klien metered boleh mempunyai had sendiri yang lebih rendah; tetapkan kedua-duanya di halaman Integrasi. Sebaik sahaja klien atau akaun anda mencapai hadnya, panggilan klien ditolak dengan 402 dan kod spend_cap_reached sehingga bulan berikutnya bermula atau had dinaikkan.

Apabila pengebilan bermeter tidak aktif

Panggilan klien metered ditolak dengan 402 dan kod metered_billing_inactive selagi pengebilan bermeter tidak aktif: sebelum ia disediakan, semasa sesuatu bayaran tertunggak, dan selepas ia dibatalkan. Sediakan, urus atau batalkan pengebilan bermeter di halaman Integrasi, di app.getlingara.com/admin. Mengurusnya akan membuka portal pengebilan Stripe, tempat anda boleh menukar kad dan membaca invois anda.

Jika terjemahan dan rujukan bahasa Inggeris berbeza, rujukan bahasa Inggeris adalah yang betul.