# Throk API 크레딧과 요금

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

## API 요금제

API와 MCP의 크레딧은 API 요금제에서 제공되며, [Throk 웹 버전](/ko/web/plans/)의 크레딧과 별도로 계산됩니다. 모든 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](/ko/api/webhooks/) | 이벤트 1건 전송당 20크레딧 |
| `GET /balance`, `GET /balance/history` | 무료 |

그 밖의 엔드포인트 요금은 [API 문서](https://developer.throk.ai/api/docs)를 참고하세요. MCP 도구는 대응하는 REST 엔드포인트와 가격이 같습니다. 자세한 내용은 [AI 어시스턴트에서 사용하기(MCP)](/ko/api/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 개발자 플랫폼](https://developer.throk.ai/dashboard)에 로그인하면 코드를 작성하지 않고도 계정의 사용 현황을 볼 수 있습니다.

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

![개발자 플랫폼의 Credits 사용 기록 페이지: 남은 크레딧, 30일 사용량, 일별 사용량 차트와 API 유형별 분포](../../../../assets/screenshots/api/portal-usage.jpg)

![개발자 플랫폼의 Credits 구매 페이지: API Lite, Standard, Plus, Premium 요금제](../../../../assets/screenshots/api/portal-plans.jpg)

## API로 잔액과 내역 조회하기

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

```bash
# 남은 크레딧
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`.