صورت‌حساب و اعتبارها
نسخهٔ API 2026-10-virile-dragon
دو روش پرداخت
هر کلاینت به یکی از دو روش صورت‌حساب می‌شود، و حالت آن هنگام ایجاد ثابت می‌شود. کلاینت allowance از سهمیهٔ پلان مالک خود مصرف می‌کند، همان سهمیه‌ای که اپلیکیشن‌های شما مصرف می‌کنند، و هرگز از هیچ کارتی پول برداشت نمی‌کند. کلاینت metered از هیچ سهمیه‌ای مصرف نمی‌کند: هر فراخوانی آن هزینه‌ای به اعتبار دارد که از کارتِ ثبت‌شده در اشتراک صورت‌حساب مصرفی شما برداشت می‌شود. فراخوانی‌ای که اپلیکیشن با توکنی از کود اجازه از جانب کاربر دیگری انجام می‌دهد، همیشه از سهمیهٔ همان کاربر مصرف می‌کند، صرف نظر از حالت کلاینت.
اعتبار برای هر فراخوانی
هر فراخوانی کلاینت metered به اندازهٔ اعتباری که حوزهٔ دسترسی آن می‌ارزد هزینه دارد، که در جدول زیر فهرست شده است؛ حوزه‌ای که 0 اعتبار می‌ارزد هزینه‌ای ندارد. unitsی که GET /v1/usage گزارش می‌دهد با همین وزن‌ها به اعتبار تبدیل می‌شود. هر فراخوانی با وزن‌هایی صورت‌حساب می‌شود که در روز انجام آن معتبر است، صرف نظر از نسخه‌ای که کلاینت به آن بسته شده است: جدول در مرجع یک نسخهٔ قدیمی‌تر وزن‌های زمان انتشار آن نسخه را ثبت کرده است، نه هزینهٔ امروزی یک فراخوانی را.
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 اویک جمله به یک شخصیت غیربازیکن بفرستید |
قیمت
هر اعتبار US$0.004 هزینه دارد. مصرف به‌صورت ماهانه، برای هر ماه تقویمی که از روز اول (UTC) آغاز می‌شود، از کارتِ ثبت‌شده در اشتراک صورت‌حساب مصرفی شما برداشت می‌شود.
سقف‌های مصارف
حساب شما یک سقف ماهانه به اعتبار دارد، و هر کلاینت metered می‌تواند سقف پایین‌تری از خود داشته باشد؛ هر دو را در صفحهٔ یکپارچه‌سازی‌ها تنظیم کنید. وقتی کلاینت یا حساب شما به سقف خود برسد، فراخوانی‌های کلاینت با 402 و کود spend_cap_reached رد می‌شوند تا زمانی که ماه بعد آغاز شود یا سقف بالا برده شود.
وقتی صورت‌حساب مصرفی فعال نیست
فراخوانی‌های کلاینت metered تا زمانی که صورت‌حساب مصرفی فعال نباشد با 402 و کود metered_billing_inactive رد می‌شوند: پیش از تنظیم آن، زمانی که پرداختی معوق مانده است، و پس از لغو آن. صورت‌حساب مصرفی را در صفحهٔ یکپارچه‌سازی‌ها، به آدرس app.getlingara.com/admin، تنظیم، مدیریت یا لغو کنید. مدیریت آن پورتال صورت‌حساب Stripe را باز می‌کند، جایی که می‌توانید کارت خود را تغییر دهید و صورت‌حساب‌های خود را ببینید.
اگر ترجمه با مرجع انگلیسی فرق داشته باشد، مرجع انگلیسی درست است.