积分与定价

积分概述

ListenHub 使用积分系统计费。积分可用于生成 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 积分

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

内容提取积分策略

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

规则	说明
预扣积分	任务开始时预扣 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 读的是这张表：

模型	Provider	积分
`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 积分，两个 provider 一致，与返回几条版本无关。

音乐与歌词的异步任务在提交时预扣积分，成功时确认扣除，失败全额退还。单价在建单时即固定，后续调价不会对进行中的任务重新计费。每个任务的实际消耗通过 creditCost 返回。

请求限制

限制项	值	说明
创建请求频率	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。

下一步

错误处理 — 积分不足（26004）等错误码的处理
技术支持 — 企业方案和定制需求
订阅查询 API — 完整的积分查询接口说明

积分概述

积分类型

订阅计划

积分消耗参考

内容提取积分策略

音乐与歌词积分策略

请求限制

查询积分余额

下一步

本页内容