ListenHubOpenAPI
API 参考

订阅与余额

查询账户订阅状态、各类积分余额及到期时间。

获取订阅详情与余额信息

GET /v1/user/subscription

查询账户的积分余额、订阅状态等信息。

请求示例

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(data);
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(data)

响应示例

{
  "code": 0,
  "message": "",
  "data": {
    "subscriptionStartedAt": 1735660800000,
    "subscriptionExpiresAt": 1767196800000,
    "usageAvailableMonthlyCredits": 500,
    "usageTotalMonthlyCredits": 1000,
    "usageAvailablePermanentCredits": 300,
    "usageTotalPermanentCredits": 500,
    "usageAvailableLimitedTimeCredits": 200,
    "totalAvailableCredits": 1000,
    "resetAt": 1735660800000,
    "platform": "web",
    "renewStatus": false,
    "paidStatus": true,
    "subscriptionPlan": {
      "name": "pro",
      "duration": "monthly",
      "platform": "web"
    }
  }
}

字段说明

  • totalAvailableCredits:总可用积分(重要)
  • usageAvailableMonthlyCredits:本月剩余积分
  • usageAvailablePermanentCredits:永久积分余额
  • usageAvailableLimitedTimeCredits:限时积分余额
  • resetAt:月度积分重置时间
  • subscriptionExpiresAt:订阅到期时间

On this page