최종 업데이트
크레딧
모든 워크스페이스에는 결제 기간마다 다시 채워지는 크레딧 지갑이 있습니다. 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}로, 조회 비용에 추가됩니다. 프로필이 반환된 경우에만 과금됩니다. |
| LIVE 새로고침 | 1,250 | POST /v1/live/creators/{uid}/refresh: 워커에게 크리에이터를 지금 확인하도록 요청합니다. |
| 내보내기 | 2,500 | POST /v1/exports: CSV 또는 Excel 파일을 생성합니다. |
| Webhook 전송 | 1 | 알림 규칙이 전송하는 각 webhook. 규칙 테스트로 보내는 webhook도 포함됩니다. |
| 무료 | 0 | 알림 규칙 관리, 내보내기 목록 조회와 다운로드, key 생성과 폐기, 이용 권한과 사용량 조회. |
레퍼런스의 각 작업에는 스코프 옆에 유형이 표시됩니다. 202 응답(수집이 아직 진행 중)은 캐시 조회로 과금됩니다.
월간 제공량
매 달력 월(UTC)마다 그 달의 첫 과금 대상 호출 또는 지갑 조회 시점에 워크스페이스 요금제의 제공량이 지급됩니다. 한 달 동안의 사용량은 제공량을 넘을 수 없습니다. 요금제는 요금 안내를 참고하세요.
| 요금제 | 월간 크레딧 |
|---|---|
| Free | 150,000 |
| Starter | 450,000 |
| Pro | 3,000,000 |
| Scale | 12,000,000 |
| Agency / Enterprise | 36,000,000 |
지갑이 비었을 때
한도를 넘게 되는 과금 대상 호출은 일반적인 오류 형식으로 402와 코드 credit_cap_exceeded를 반환합니다. 무료 작업은 계속 사용할 수 있습니다. 지갑은 다음 달이 시작될 때 다시 채워지며, 월 중간에 업그레이드하면 한도가 올라갑니다.
실패한 호출은 과금되지 않습니다
크레딧은 호출이 시작될 때 예약되고 호출이 실패하면 반환되므로,
4xx 또는 5xx 응답에는 비용이 들지 않습니다. 2xx 또는 3xx 응답은 과금됩니다.지갑 조회
GET /v1/entitlements는 요금제, 한도, 현재 기간의 지갑을 반환하고, GET /v1/usage는 작업별 사용량을 보여 줍니다. 둘 다 무료이며 keys:manage 스코프가 필요합니다.
bash
curl "https://api.toktokdata.live/v1/entitlements" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY" # data.credits: { "period": "2026-11-01", "monthlyAllotment": …, "hardCap": …, "spent": …, "remaining": … }이 페이지가 도움이 되었나요?