Cập nhật lần cuối
Credit
Mỗi workspace có một ví credit được nạp lại sau mỗi kỳ thanh toán. Lệnh gọi API và lượt đọc trên dashboard cùng trừ từ một ví; phần tham chiếu ghi rõ loại của từng thao tác.
Chi phí của một thao tác
| Loại | Credit mỗi lệnh gọi | Áp dụng cho |
|---|---|---|
| Đọc dữ liệu cache | 1 | Mọi lượt đọc dữ liệu đã lưu: bảng xếp hạng, creator, insight, video, bình luận, xu hướng, phiên LIVE. Liệt kê API key (GET /v1/api-keys) cũng là một lượt đọc cache. |
| Danh sách follow | 4,000 | GET /v1/creators/{uid}/following hoặc /followers khi danh sách phải được thu thập mới (thay cho 1). |
| Bình luận | 500 | GET /v1/videos/{id}/comments khi bình luận phải được thu thập mới (thay cho 1). |
| Phân giải hồ sơ | 1,250 | GET /v1/creators/{uid} khi một hồ sơ đã cũ được phân giải lại, cộng thêm vào lượt đọc. Chỉ tính phí nếu có hồ sơ trả về. |
| Làm mới trạng thái live | 1,250 | POST /v1/live/creators/{uid}/refresh: yêu cầu worker kiểm tra một creator ngay lúc này. |
| Xuất dữ liệu | 2,500 | POST /v1/exports: tạo một tệp CSV hoặc Excel. |
| Gửi webhook | 1 | Mỗi webhook mà một luật cảnh báo gửi đi, kể cả webhook do lần thử luật gửi. |
| Miễn phí | 0 | Quản lý luật cảnh báo, liệt kê và tải xuống bản xuất, tạo và thu hồi key, quyền lợi gói và mức sử dụng. |
Mỗi thao tác trong phần tham chiếu hiển thị loại của nó cạnh scope. Một response 202 (việc thu thập vẫn đang chạy) được tính như một lượt đọc cache.
Hạn mức hằng tháng
Mỗi tháng dương lịch (UTC), gói của workspace cấp hạn mức của nó vào lần gọi có tính phí hoặc lần đọc ví đầu tiên trong tháng. Chi tiêu trong một tháng không thể vượt quá hạn mức. Xem bảng giá để biết các gói.
| Gói | Credit mỗi tháng |
|---|---|
| Free | 150,000 |
| Starter | 450,000 |
| Pro | 3,000,000 |
| Scale | 12,000,000 |
| Agency / Enterprise | 36,000,000 |
Khi ví hết credit
Một lệnh gọi có tính phí mà sẽ vượt hạn mức trả về 402 với code credit_cap_exceeded trong envelope lỗi thông thường. Các thao tác miễn phí vẫn hoạt động. Ví được nạp lại vào đầu tháng sau; nâng gói giữa tháng sẽ tăng hạn mức.
4xx hoặc 5xx không tốn gì. Response 2xx hoặc 3xx thì bị tính phí.Đọc ví
GET /v1/entitlements trả về gói, các giới hạn và ví của kỳ hiện tại; GET /v1/usage chia nhỏ mức chi tiêu theo từng thao tác. Cả hai đều miễn phí và cần scope keys:manage.
curl "https://api.next.toktokdata.live/v1/entitlements" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY" # data.credits: { "period": "2026-11-01", "monthlyAllotment": …, "hardCap": …, "spent": …, "remaining": … }