Tính phí và tín dụng
Phiên bản API 2026-10-virile-dragon
Hai cách thanh toán
Một ứng dụng khách được tính phí theo một trong hai cách, và chế độ của nó được cố định khi tạo. Ứng dụng khách allowance tiêu hạn mức trong gói của chủ sở hữu, cùng hạn mức với các ứng dụng của bạn, và không bao giờ trừ tiền vào thẻ. Ứng dụng khách metered không tiêu hạn mức: mỗi lệnh gọi của nó tốn tín dụng, được trừ vào thẻ trong gói đăng ký tính phí theo mức dùng của bạn. Lệnh gọi mà một ứng dụng thực hiện thay cho người dùng khác, bằng token lấy từ mã ủy quyền, luôn tiêu hạn mức của người dùng đó, bất kể chế độ của ứng dụng khách.
Tín dụng mỗi lệnh gọi
Một lệnh gọi của ứng dụng khách metered tốn số tín dụng mà phạm vi của nó có giá trị, được liệt kê trong bảng dưới đây; phạm vi có giá trị 0 tín dụng thì không tốn gì. units mà GET /v1/usage báo cáo được quy đổi ra tín dụng theo các trọng số này. Một lệnh gọi được tính phí theo trọng số có hiệu lực vào ngày thực hiện, bất kể ứng dụng khách được ghim vào phiên bản nào: bảng trong tài liệu tham khảo của một phiên bản cũ hơn ghi lại trọng số tại thời điểm phiên bản đó được phát hành, chứ không phải chi phí của một lệnh gọi hôm nay.
vocab:generate | Tạo danh sách từ vựng. | Tạo danh sách từ vựng |
lesson_plans:read | Đọc giáo án của bạn và kết nối lại với tiến trình của chúng. | Lấy giáo ánKết nối lại với giáo án |
lesson_plans:write | Tạo giáo án. | Tạo giáo án |
tutor:converse | Trò chuyện với gia sư. Yêu cầu gói trả phí. | Gửi một lượt cho gia sư |
usage:read | Xem hạn mức còn lại của bạn, hoặc mức sử dụng tháng này của một client `metered`. | Lấy hạn mức còn lại của bạn |
events:read | Đọc các sự kiện về tài khoản của bạn, và đăng ký các điểm cuối nhận chúng. | Liệt kê sự kiệnTruyền luồng sự kiện |
events:write | Gửi sự kiện từ trò chơi hoặc tích hợp của bạn đến Lingara. | Gửi sự kiện |
embed:mint | Cấp token ngắn hạn cho người chơi của trò chơi hoặc trang web của bạn, và xóa người chơi. Chỉ dành cho client tính phí theo mức dùng. | Cấp token cho người chơiXóa người chơiHủy liên kết người chơi khỏi tài khoản Lingara của họ |
embed:play | Hành động thay người chơi: gửi kết quả luyện tập của họ và trò chuyện với họ qua NPC. | Liên kết người chơi với tài khoản Lingara của họGửi một câu thoại cho NPC |
Giá
Một tín dụng có giá US$0.004. Mức dùng được tính phí hằng tháng, cho mỗi tháng dương lịch bắt đầu từ ngày 1 (UTC), vào thẻ trong gói đăng ký tính phí theo mức dùng của bạn.
Hạn mức chi tiêu
Tài khoản của bạn có một hạn mức hằng tháng tính bằng tín dụng, và mỗi ứng dụng khách metered có thể có hạn mức riêng thấp hơn; hãy đặt cả hai trên trang Tích hợp. Khi ứng dụng khách hoặc tài khoản của bạn chạm hạn mức, các lệnh gọi của ứng dụng khách bị từ chối với 402 và mã spend_cap_reached cho đến khi tháng tiếp theo bắt đầu hoặc hạn mức được nâng lên.
Khi tính phí theo mức dùng không hoạt động
Các lệnh gọi của ứng dụng khách metered bị từ chối với 402 và mã metered_billing_inactive khi tính phí theo mức dùng không hoạt động: trước khi được thiết lập, trong khi có khoản thanh toán quá hạn, và sau khi bị hủy. Hãy thiết lập, quản lý hoặc hủy tính phí theo mức dùng trên trang Tích hợp, tại app.getlingara.com/admin. Quản lý sẽ mở cổng thanh toán của Stripe, nơi bạn có thể đổi thẻ và xem hóa đơn của mình.
Nếu bản dịch và tài liệu tham chiếu tiếng Anh khác nhau, tài liệu tham chiếu tiếng Anh là bản đúng.