Penagihan dan kredit
Versi API 2026-10-virile-dragon
Dua cara membayar
Klien ditagih dengan salah satu dari dua cara, dan modenya ditetapkan saat klien dibuat. Klien allowance menggunakan kuota paket pemiliknya, kuota yang sama dengan aplikasi Anda, dan tidak pernah menagih kartu. Klien metered tidak menggunakan kuota: setiap panggilannya memakan kredit, yang ditagihkan ke kartu pada langganan penagihan per pemakaian Anda. Panggilan yang dilakukan aplikasi untuk pengguna lain, dengan token dari kode otorisasi, selalu menggunakan kuota pengguna itu, apa pun mode kliennya.
Kredit per panggilan
Satu panggilan klien metered memakan kredit sebesar nilai cakupannya, yang tercantum dalam tabel di bawah; cakupan bernilai 0 kredit tidak dikenai biaya. units yang dilaporkan GET /v1/usage dikonversi ke kredit dengan bobot ini. Panggilan ditagih dengan bobot yang berlaku pada hari panggilan itu dilakukan, apa pun versi yang disematkan pada klien: tabel dalam referensi versi lama mencatat bobot saat versi itu diterbitkan, bukan biaya satu panggilan hari ini.
vocab:generate | Buat daftar kosakata. | Buat daftar kosakata |
lesson_plans:read | Baca rencana pelajaran Anda dan sambungkan kembali ke progresnya. | Ambil rencana pelajaranSambungkan kembali ke rencana pelajaran |
lesson_plans:write | Buat rencana pelajaran. | Buat rencana pelajaran |
tutor:converse | Bercakap dengan tutor. Memerlukan paket berbayar. | Kirim giliran tutor |
usage:read | Lihat sisa kuota Anda, atau penggunaan klien `metered` bulan ini. | Lihat sisa kuota Anda |
events:read | Baca event tentang akun Anda, dan daftarkan endpoint yang menerimanya. | Daftar peristiwaStream peristiwa |
events:write | Kirim event dari game atau integrasi Anda ke Lingara. | Kirim peristiwa |
embed:mint | Terbitkan token berumur pendek untuk pemain game atau situs Anda, dan hapus pemain. Hanya untuk klien bertarif pemakaian. | Terbitkan token untuk pemainHapus pemainLepaskan tautan pemain dari akun Lingara mereka |
embed:play | Bertindak atas nama pemain: kirim hasil latihannya dan lakukan percakapan NPC dengannya. | Tautkan pemain ke akun Lingara merekaKirim satu kalimat ke NPC |
Harga
Satu kredit seharga US$0.004. Pemakaian ditagih bulanan, untuk setiap bulan kalender yang dimulai pada tanggal 1 (UTC), ke kartu pada langganan penagihan per pemakaian Anda.
Batas pengeluaran
Akun Anda memiliki batas bulanan dalam kredit, dan setiap klien metered dapat memiliki batasnya sendiri yang lebih rendah; atur keduanya di halaman Integrasi. Begitu klien atau akun Anda mencapai batasnya, panggilan klien ditolak dengan 402 dan kode spend_cap_reached sampai bulan berikutnya dimulai atau batasnya dinaikkan.
Saat penagihan per pemakaian tidak aktif
Panggilan klien metered ditolak dengan 402 dan kode metered_billing_inactive selama penagihan per pemakaian tidak aktif: sebelum disiapkan, selama ada pembayaran yang terlambat, dan setelah dibatalkan. Siapkan, kelola, atau batalkan penagihan per pemakaian di halaman Integrasi, di app.getlingara.com/admin. Mengelolanya akan membuka portal penagihan Stripe, tempat Anda dapat mengganti kartu dan membaca tagihan Anda.
Jika terjemahan berbeda dengan referensi berbahasa Inggris, referensi berbahasa Inggris yang berlaku.