Credits & Pricing
Credit types, consumption reference, and rate limits.
Credits Overview
ListenHub uses a credit-based billing system. Credits can be used for all API features including AI podcast generation, text-to-speech, AI video, image generation, and content extraction. New users receive 100 credits upon registration, so you can start using the API right away.
Credit Types
| Type | Validity | How to Get |
|---|---|---|
| Monthly credits | Valid within current billing cycle, reset at renewal | Auto-issued with subscription |
| Permanent credits | Never expire | Purchase credit packs, referral rewards, sharing rewards |
| Limited-time credits | Expire on specified date | Daily check-in, official campaigns |
Deduction order: limited-time credits → monthly credits → permanent credits.
Subscription Plans
| Plan | Monthly Credits |
|---|---|
| Basic | 1,300 credits/month |
| Pro | 2,700 credits/month |
| Max | 30,000 credits/month |
In addition to subscriptions, you can purchase credit packs for permanent credits.
Credit Consumption Reference
| Content Type | Approximate Cost |
|---|---|
| 5-minute AI podcast | ~24 credits |
| 10-minute text-to-speech | ~40 credits |
| AI video generation | Varies by model, resolution, duration, aspect ratio, and whether a reference video is used. Call POST /v1/video-generation/estimate-credits before creating a task. |
| Content extraction | 5 credits minimum; 100 credits per 100,000 characters (max 500 credits) |
| Music generation | 5–20 credits per generation task, by model tier. Analysis and edit endpoints are flat-rated — see the policy below |
| Lyrics generation | 2 credits per request |
Credit consumption values above are approximate. Actual consumption is
calculated in real time by the system. Call GET /v1/user/subscription to
check your balance at any time.
Seedance 2.5
Draft and final are separate tasks and separate charges. A final does not subtract the draft charge or treat the draft output as another reference video. A failed final refunds its own reserved charge and leaves the successful draft available.
Video estimates use the sum of input-video durations and the selected output geometry at 24 fps, subject to minimum-token rules. Native input dimensions validate each file; they are not independently priced by pixel area. Audio-only requests use the no-video rate; audio seconds are not added to video seconds. Automatic parameters use a conservative estimate, and completion settles against actual provider token usage. The estimate is not a guaranteed maximum.
2.5 has its own rate table. Relative to 2.0 Pro, the per-token rate rises by 52.86% / 48.84% at 480p or 720p (without / with video input), and 51.95% / 48.94% at 1080p. This does not imply the same percentage change in every task or a fixed profit margin.
OpenAPI estimates return tokens and estimatedCostUsd, not internal credits. Reserve the estimate at submission; actual-token settlement can refund or add the difference. Keep the returned task ID and check its state before retrying.
Full limits and runnable request shapes.
Content Extraction Credit Policy
Content extraction uses a pre-deduction model:
| Rule | Details |
|---|---|
| Pre-deduction | 5 credits are reserved when a task starts |
| Actual charge | 100 credits per 100,000 characters of extracted content; if the actual amount is less than 5, the actual amount is charged |
| Failure refund | All pre-deducted credits are fully refunded if extraction fails |
| Default limit | 100,000 characters per request (100 credits) |
| Maximum limit | 500,000 characters per request (500 credits) |
Credits are calculated based on actual extracted content length. A 3,000-character article costs 3 credits (actual); a 100,000-character article costs 100 credits; a 250,000-character article costs 250 credits.
Music and Lyrics Credit Policy
Music generation prices by model tier. POST /v1/music/generate, /v1/music/instrumental, and /v1/music/cover read this table:
| Model | Provider | Credits |
|---|---|---|
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 is the Mureka default and V6 is the Suno default, so a request that omits model costs 10 credits on Mureka and 20 on Suno. Every tier listed stays selectable.
The remaining music endpoints are flat-rated regardless of model: /v1/music/remix 10, /v1/music/extend 10 on mureka-7.6 and on auto (which resolves to mureka-7.6 before pricing) and 15 on every other model including all Suno tiers, /v1/music/soundtrack 15, /v1/music/track 15, /v1/music/describe 15, /v1/music/recognize 3, and /v1/music/stem 10 on audio-separation-1 or 100 on audio-separation-2.
Lyrics generation (POST /v1/lyrics/generate) costs a flat 2 credits per request on either provider, whatever the number of variants returned.
Async music and lyrics tasks reserve credits at submission, confirm them on success, and refund them in full on failure. The price is fixed when the task is created, so a later price change never re-bills a task already in flight. Each task reports what it actually cost as creditCost.
Rate Limits
| Limit | Value | Description |
|---|---|---|
| Creation request rate | 3 RPM | Up to 3 creation requests per minute |
| AI video generation rate | 5 RPM | Applied per user on POST /v1/video-generation/generate and the PixVerse endpoint |
| Exceeded limit error | 29998 | Implement a backoff retry strategy |
Recommended strategies:
- Implement a request queue to avoid burst requests
- Use exponential backoff for retries
- Monitor request frequency to prevent hitting limits
Check Credit Balance
Query your current credit details via the 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'])The response includes monthly, permanent, limited-time, and total available credits. See Subscription API for full details.
Next Steps
- Error Handling — Handle insufficient credits (26004) and other errors
- Support — Enterprise plans and custom requirements
- Subscription API — Full credit query endpoint reference