Credits & Pricing

Credits Overview

ListenHub uses a credit-based billing system. Credits can be used for all API features including AI podcast generation, text-to-speech, 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
Content extraction	5 credits minimum; 100 credits per 100,000 characters (max 500 credits)

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.

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.

Rate Limits

Limit	Value	Description
Creation request rate	3 RPM	Up to 3 creation requests per minute
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

On this page