크레딧 및 요금
크레딧 종류, 소비량 참고표, 레이트 리밋.
크레딧 개요
ListenHub는 크레딧(credit) 기반 과금 시스템을 사용합니다. 크레딧은 AI 팟캐스트 생성, 텍스트 음성 변환, AI 비디오, 이미지 생성, 콘텐츠 추출 등 모든 API 기능에 사용할 수 있습니다. 신규 사용자는 가입 시 100 크레딧을 받으므로 바로 API를 사용해 볼 수 있습니다.
크레딧 종류
| 종류 | 유효 기간 | 획득 방법 |
|---|---|---|
| 월간 크레딧 | 현재 결제 주기 내에서만 유효, 갱신 시 초기화 | 구독과 함께 자동 지급 |
| 영구 크레딧 | 만료되지 않음 | 크레딧 팩 구매, 추천 보상, 공유 보상 |
| 한정 기간 크레딧 | 지정된 날짜에 만료 | 매일 출석 체크, 공식 이벤트 |
차감 순서: 한정 기간 크레딧 → 월간 크레딧 → 영구 크레딧.
구독 플랜
| 플랜 | 월간 크레딧 |
|---|---|
| Basic | 1,300 크레딧/월 |
| Pro | 2,700 크레딧/월 |
| Max | 30,000 크레딧/월 |
구독 외에도 크레딧 팩을 구매해 영구 크레딧을 얻을 수 있습니다.
크레딧 소비량 참고표
| 콘텐츠 유형 | 대략적인 소비량 |
|---|---|
| 5분 AI 팟캐스트 | ~24 크레딧 |
| 10분 텍스트 음성 변환 | ~40 크레딧 |
| AI 비디오 생성 | 모델, 해상도, 길이, 화면 비율, 참조 비디오 사용 여부에 따라 달라집니다. 작업을 생성하기 전에 POST /v1/video-generation/estimate-credits를 호출하세요. |
| 콘텐츠 추출 | 최소 5 크레딧, 100,000자당 100 크레딧(최대 500 크레딧) |
위 크레딧 소비량은 대략적인 값입니다. 실제 소비량은 시스템이 실시간으로
계산합니다. GET /v1/user/subscription을 호출하면 언제든지 잔액을 확인할 수
있습니다.
콘텐츠 추출 크레딧 정책
콘텐츠 추출은 선차감 방식을 사용합니다:
| 규칙 | 상세 |
|---|---|
| 선차감 | 작업이 시작될 때 5 크레딧이 예약됩니다 |
| 실제 청구 | 추출된 콘텐츠 100,000자당 100 크레딧, 실제 금액이 5 미만이면 실제 금액만 청구됩니다 |
| 실패 시 환불 | 추출이 실패하면 선차감된 크레딧이 전액 환불됩니다 |
| 기본 상한 | 요청당 100,000자(100 크레딧) |
| 최대 상한 | 요청당 500,000자(500 크레딧) |
크레딧은 실제로 추출된 콘텐츠 길이를 기준으로 계산됩니다. 3,000자 기사는 3 크레딧(실제 소비량), 100,000자 기사는 100 크레딧, 250,000자 기사는 250 크레딧이 듭니다.
레이트 리밋
| 제한 항목 | 값 | 설명 |
|---|---|---|
| 생성 요청 빈도 | 3 RPM | 분당 최대 3회의 생성 요청 |
| AI 비디오 생성 빈도 | 5 RPM | POST /v1/video-generation/generate와 PixVerse 엔드포인트에 사용자별로 적용 |
| 제한 초과 에러 | 29998 | 백오프 재시도 전략을 구현하세요 |
권장 전략:
- 요청 큐를 구현해 순간적인 요청 폭주를 방지하세요
- 재시도에는 지수 백오프(exponential backoff)를 사용하세요
- 요청 빈도를 모니터링해 제한에 걸리지 않도록 하세요
크레딧 잔액 확인
API로 현재 크레딧 상세 정보를 조회합니다:
curl -X GET "https://api.marswave.ai/openapi/v1/user/subscription" \
-H "Authorization: Bearer $LISTENHUB_API_KEY"const response = await fetch(
'https://api.marswave.ai/openapi/v1/user/subscription',
{
headers: {
Authorization: `Bearer ${process.env.LISTENHUB_API_KEY}`,
},
},
)
const data = await response.json()
console.log('Available credits:', data.data.totalAvailableCredits)import os
import requests
response = requests.get(
'https://api.marswave.ai/openapi/v1/user/subscription',
headers={'Authorization': f'Bearer {os.environ["LISTENHUB_API_KEY"]}'}
)
data = response.json()
print('Available credits:', data['data']['totalAvailableCredits'])응답에는 월간 크레딧, 영구 크레딧, 한정 기간 크레딧, 총 사용 가능 크레딧이 포함됩니다. 자세한 내용은 구독 API를 참고하세요.