ListenHubOpenAPI
EN中文

积分与定价

积分类型、消耗参考与请求限制。

积分概述

ListenHub 使用积分系统计费。积分可用于生成 AI 播客、文本转语音、内容提取等所有 API 功能。新用户注册即获 100 积分，可以直接体验 API。

积分类型

类型有效期获取方式
月度积分当前订阅周期内有效，周期结束后清零订阅自动发放
永久积分永不过期购买积分包、邀请奖励、分享奖励
限时积分发放时注明有效期，逾期失效每日签到、官方活动

扣除顺序：限时积分 → 月度积分 → 永久积分。

订阅计划

计划月度积分
Basic1,300 积分/月
Pro2,700 积分/月
Max30,000 积分/月

除订阅外，还可以购买积分包获取永久积分。

积分消耗参考

内容类型参考消耗
5 分钟 AI 播客~24 积分
10 分钟文字转语音~40 积分
内容提取最低 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 次创建请求
超出限制错误码29998实现退避重试策略

推荐策略：

  • 实现请求队列，避免突发请求
  • 使用指数退避算法进行重试
  • 监控请求频率，预防触发限制

查询积分余额

通过 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。

下一步

On this page

积分概述积分类型订阅计划积分消耗参考内容提取积分策略请求限制查询积分余额下一步