อัปเดตล่าสุด
เครดิต
ทุกเวิร์กสเปซมีกระเป๋าเครดิตที่เติมใหม่ทุกรอบการเรียกเก็บเงิน การเรียก API และการอ่านข้อมูลในแดชบอร์ดใช้เครดิตจากกระเป๋าเดียวกัน เอกสารอ้างอิงระบุประเภทของการดำเนินการแต่ละรายการไว้
ค่าใช้จ่ายของแต่ละการดำเนินการ
| ประเภท | เครดิตต่อการเรียก | ครอบคลุม |
|---|---|---|
| อ่านข้อมูลแคช | 1 | ทุกการอ่านข้อมูลที่จัดเก็บไว้: อันดับ ครีเอเตอร์ ข้อมูลเชิงลึก วิดีโอ ความคิดเห็น เทรนด์ เซสชัน LIVE การแสดงรายการ API key (GET /v1/api-keys) ก็นับเป็นการอ่านข้อมูลแคชเช่นกัน |
| รายชื่อการติดตาม | 4,000 | GET /v1/creators/{uid}/following หรือ /followers เมื่อต้องเก็บรายชื่อใหม่ (แทนที่จะเป็น 1) |
| ความคิดเห็น | 500 | GET /v1/videos/{id}/comments เมื่อต้องเก็บความคิดเห็นใหม่ (แทนที่จะเป็น 1) |
| ดึงโปรไฟล์ใหม่ | 1,250 | GET /v1/creators/{uid} เมื่อต้องดึงโปรไฟล์ที่ล้าสมัยใหม่อีกครั้ง โดยคิดเพิ่มจากการอ่าน และคิดเฉพาะเมื่อได้โปรไฟล์กลับมา |
| รีเฟรชสถานะไลฟ์ | 1,250 | POST /v1/live/creators/{uid}/refresh: ขอให้ worker ตรวจสอบครีเอเตอร์ทันที |
| ส่งออก | 2,500 | POST /v1/exports: สร้างไฟล์ CSV หรือ Excel |
| ส่ง webhook | 1 | webhook แต่ละครั้งที่กฎการแจ้งเตือนส่งออกไป รวมถึงครั้งที่ส่งจากการทดสอบกฎ |
| ฟรี | 0 | การจัดการกฎการแจ้งเตือน การแสดงรายการและดาวน์โหลดไฟล์ส่งออก การสร้างและเพิกถอนคีย์ สิทธิ์การใช้งาน และปริมาณการใช้ |
การดำเนินการแต่ละรายการในเอกสารอ้างอิงจะแสดงประเภทไว้ข้างสโคป ผลลัพธ์ 202 (การเก็บข้อมูลยังดำเนินอยู่) จะคิดเป็นการอ่านข้อมูลแคช
โควตารายเดือน
ทุกเดือนปฏิทิน (UTC) แพ็กเกจของเวิร์กสเปซจะมอบโควตาเครดิตให้ เมื่อมีการเรียกที่คิดเครดิตหรือการอ่านยอดกระเป๋าครั้งแรกของเดือน ยอดใช้จ่ายในเดือนหนึ่งจะเกินโควตาไม่ได้ ดูแพ็กเกจต่าง ๆ ได้ที่หน้า ราคา
| แพ็กเกจ | เครดิตต่อเดือน |
|---|---|
| Free | 150,000 |
| Starter | 450,000 |
| Pro | 3,000,000 |
| Scale | 12,000,000 |
| Agency / Enterprise | 36,000,000 |
เมื่อกระเป๋าเครดิตว่าง
การเรียกที่คิดเครดิตซึ่งจะทำให้เกินเพดานจะได้รับ 402 พร้อม code credit_cap_exceeded ใน โครงสร้างข้อผิดพลาดตามปกติ การดำเนินการที่ฟรียังทำงานได้ กระเป๋าจะเติมใหม่เมื่อเริ่มเดือนถัดไป และการอัปเกรดแพ็กเกจระหว่างเดือนจะเพิ่มเพดานให้สูงขึ้น
4xx หรือ 5xx จึงไม่มีค่าใช้จ่าย ส่วน 2xx หรือ 3xx จะถูกคิดเครดิตอ่านยอดในกระเป๋าเครดิต
GET /v1/entitlements ส่งคืนแพ็กเกจ ขีดจำกัด และกระเป๋าเครดิตของรอบปัจจุบัน ส่วน GET /v1/usage แจกแจงยอดใช้จ่ายตามการดำเนินการ ทั้งสองรายการไม่มีค่าใช้จ่าย และต้องใช้สโคป keys:manage
curl "https://api.toktokdata.live/v1/entitlements" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY" # data.credits: { "period": "2026-11-01", "monthlyAllotment": …, "hardCap": …, "spent": …, "remaining": … }