크레딧 및 요금
크레딧 종류, 소비량 참고표, 레이트 리밋.
크레딧 개요
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 크레딧) |
| 음악 생성 | 생성 작업당 모델 등급에 따라 5–20 크레딧. 분석 및 편집 엔드포인트는 고정 요금 — 아래 정책 참고 |
| 가사 생성 | 요청당 2 크레딧 |
위 크레딧 소비량은 대략적인 값입니다. 실제 소비량은 시스템이 실시간으로
계산합니다. GET /v1/user/subscription을 호출하면 언제든지 잔액을 확인할 수
있습니다.
콘텐츠 추출 크레딧 정책
콘텐츠 추출은 선차감 방식을 사용합니다:
| 규칙 | 상세 |
|---|---|
| 선차감 | 작업이 시작될 때 5 크레딧이 예약됩니다 |
| 실제 청구 | 추출된 콘텐츠 100,000자당 100 크레딧, 실제 금액이 5 미만이면 실제 금액만 청구됩니다 |
| 실패 시 환불 | 추출이 실패하면 선차감된 크레딧이 전액 환불됩니다 |
| 기본 상한 | 요청당 100,000자(100 크레딧) |
| 최대 상한 | 요청당 500,000자(500 크레딧) |
크레딧은 실제로 추출된 콘텐츠 길이를 기준으로 계산됩니다. 3,000자 기사는 3 크레딧(실제 소비량), 100,000자 기사는 100 크레딧, 250,000자 기사는 250 크레딧이 듭니다.
음악 및 가사 크레딧 정책
음악 생성은 모델 등급별로 과금됩니다. POST /v1/music/generate, /v1/music/instrumental, /v1/music/cover가 이 표를 사용합니다:
| 모델 | 프로바이더 | 크레딧 |
|---|---|---|
mureka-7.6 | Mureka | 5 |
auto, mureka-8, mureka-9, mureka-o2 | Mureka | 10 |
V4, V4_5, V4_5PLUS, V4_5ALL, V5 | Suno | 15 |
V5_5, V6 | Suno | 20 |
auto가 Mureka 기본값이고 V6이 Suno 기본값이므로, model을 생략한 요청은 Mureka에서 10 크레딧, Suno에서 20 크레딧이 듭니다. 표에 있는 등급은 모두 명시적으로 지정할 수 있습니다.
나머지 음악 엔드포인트는 모델과 무관하게 고정 요금입니다: /v1/music/remix 10, /v1/music/extend는 mureka-7.6과 auto(과금 전에 mureka-7.6으로 해석됩니다)에서 10, 그 외 모델(모든 Suno 등급 포함)에서 15, /v1/music/soundtrack 15, /v1/music/track 15, /v1/music/describe 15, /v1/music/recognize 3, /v1/music/stem은 audio-separation-1에서 10, audio-separation-2에서 100입니다.
가사 생성(POST /v1/lyrics/generate)은 프로바이더와 무관하게, 후보가 몇 개 돌아오든 요청당 고정 2 크레딧입니다.
음악과 가사의 비동기 작업은 요청 시점에 크레딧을 예약하고, success가 되면 확정하며, 실패하면 전액 환불합니다. 요금은 작업이 생성되는 시점에 고정되므로, 이후 가격이 바뀌어도 진행 중인 작업에 다시 청구되지 않습니다. 실제 소비량은 작업마다 creditCost로 반환됩니다.
레이트 리밋
| 제한 항목 | 값 | 설명 |
|---|---|---|
| 생성 요청 빈도 | 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를 참고하세요.