RoomScope

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ạiCredit mỗi lệnh gọiÁp dụng cho
Đọc dữ liệu cache1Mọ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 follow4,000GET /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ận500GET /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,250GET /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 live1,250POST /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ệu2,500POST /v1/exports: tạo một tệp CSV hoặc Excel.
Gửi webhook1Mỗ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í0Quả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óiCredit mỗi tháng
Free150,000
Starter450,000
Pro3,000,000
Scale12,000,000
Agency / Enterprise36,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.

Lệnh gọi thất bại không bị tính phí
Credit được giữ chỗ khi lệnh gọi bắt đầu và được hoàn lại nếu nó thất bại, nên một response 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.

bash
curl "https://api.next.toktokdata.live/v1/entitlements" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY" # data.credits: { "period": "2026-11-01", "monthlyAllotment": …, "hardCap": …, "spent": …, "remaining": … }
Trang này có hữu ích không?