ListenHubOpenAPI

积分与定价

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

积分概述

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

积分类型

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

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

订阅计划

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

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

积分消耗参考

内容类型参考消耗
5 分钟 AI 播客~24 积分
10 分钟文字转语音~40 积分
AI 视频生成根据模型、分辨率、时长、宽高比以及是否使用参考视频实时计算。创建任务前可调用 POST /v1/video-generation/estimate-credits 预估。
内容提取最低 5 积分;每 100,000 字符消耗 100 积分(最高 500 积分)

以上积分消耗数据仅供参考,实际消耗以系统实时计算为准。可通过订阅查询接口随时查询积分余额。

内容提取积分策略

内容提取采用预扣积分模式:

规则说明
预扣积分任务开始时预扣 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实现退避重试策略

推荐策略

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

查询积分余额

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