Throk API 크레딧과 요금

API를 호출할 때마다 크레딧(credits)이 차감됩니다. 차감된 크레딧은 응답의 credits_consumed 필드에 표시됩니다.

API 요금제

API와 MCP의 크레딧은 API 요금제에서 제공되며, Throk 웹 버전의 크레딧과 별도로 계산됩니다. 모든 API 키는 같은 계정의 크레딧을 공유합니다.

요금제	가격	월간 크레딧	Webhook
API Lite	US$30 / 월	15,000	—
API Standard	US$100 / 월	100,000	✅
API Plus	US$500 / 월	1,000,000	✅
API Premium	US$2,500 / 월	6,000,000	✅

크레딧은 구매일로부터 1개월간 유효하며, 다 쓰지 못한 크레딧은 다음 달로 이월되지 않습니다.
크레딧 추가 구매: API Standard 이상 요금제에서 일회성으로 추가 구매할 수 있습니다. 요금은 10,000크레딧당 Standard US$10, Plus US$5, Premium US$4입니다. 추가 구매한 크레딧은 현재 청구 주기 안에서만 사용할 수 있습니다.
요금제와 결제 수단은 개발자 플랫폼의 Credits 구매 페이지에서 관리할 수 있습니다. 자세한 내용은 아래를 참고하세요.

주요 엔드포인트의 요금

엔드포인트	요금
`GET /post/search`	반환된 게시물 1개당 1크레딧. `include_details=true`이면 게시물당 2크레딧
`GET /post/keyword-trend`	3크레딧 × 키워드 수 × 일수. `include_engagement=true`이면 4크레딧 × 키워드 수 × 일수
`GET /post/hot`	30개에 70크레딧, 1개 추가될 때마다 2크레딧 추가. `sort=impression:desc`이면 기본 요금 100크레딧. 요청한 `size` 기준으로 과금
`GET /post/semantic-search`	처음 10개에 30크레딧, 이후 1개당 2크레딧 추가. 결과가 없어도 호출당 최소 30크레딧
Webhook	이벤트 1건 전송당 20크레딧
`GET /balance`, `GET /balance/history`	무료

그 밖의 엔드포인트 요금은 API 문서를 참고하세요. MCP 도구는 대응하는 REST 엔드포인트와 가격이 같습니다. 자세한 내용은 AI 어시스턴트에서 사용하기(MCP)를 참고하세요.

예시

키워드 3개로 검색해 게시물 50개 반환: 50크레딧
같은 검색에 include_details=true 추가: 100크레딧
키워드 2개의 30일 트렌드 조회: 3 × 2 × 30 = 180크레딧
위와 같은 조회에 참여 지표 추가(include_engagement=true): 4 × 2 × 30 = 240크레딧

크레딧이 부족할 때

Throk은 조회하기 전에 비용을 먼저 추정합니다. 크레딧이 부족하면 HTTP 400과 Insufficient credits를 반환하며, 조회를 실행하지 않고 크레딧도 차감하지 않습니다.

개발자 플랫폼에서 잔액과 내역 확인하기

Throk 개발자 플랫폼에 로그인하면 코드를 작성하지 않고도 계정의 사용 현황을 볼 수 있습니다.

페이지	할 수 있는 일
개요	남은 크레딧, 30일간 사용량과 호출 수, Webhook 성공률
API 키	키 생성과 삭제, 계정 크레딧 잔액 확인
Credits 사용 기록	일별 사용량 차트, API 유형별 분포, 호출별 시각·사용량·키·매개변수
Credits 구매	API 요금제 변경, 크레딧 추가 구매, Stripe에서 결제 수단과 인보이스 관리
엔드포인트 및 규칙, 전송 기록	Webhook 설정과 전송 결과 확인

개발자 플랫폼의 Credits 사용 기록 페이지: 남은 크레딧, 30일 사용량, 일별 사용량 차트와 API 유형별 분포

개발자 플랫폼의 Credits 구매 페이지: API Lite, Standard, Plus, Premium 요금제

API로 잔액과 내역 조회하기

코드에서도 조회할 수 있으며, 두 엔드포인트 모두 크레딧이 차감되지 않습니다.

# 남은 크레딧
curl 'https://premium-api.throk.ai/balance' \
  -H 'Authorization: Bearer sk-throk-...'

# 사용 내역(페이지당 50건)
curl 'https://premium-api.throk.ai/balance/history?page=1' \
  -H 'Authorization: Bearer sk-throk-...'

사용 내역에서 MCP로 호출한 항목에는 mcp: 접두사가 붙습니다. 예: mcp:keywords.