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 クレジット）

上記のクレジット消費量は目安です。実際の消費量はシステムがリアルタイムで 計算します。GET /v1/user/subscription を呼び出せば、いつでも残高を 確認できます。

コンテンツ抽出のクレジットポリシー

コンテンツ抽出は事前差し引き方式を採用しています：

ルール内容
事前差し引きタスク開始時に 5 クレジットを確保します
実際の課金抽出したコンテンツ 100,000 文字あたり 100 クレジット。実際の消費量が 5 未満の場合は実際の消費量を課金します
失敗時の返還抽出に失敗した場合、事前に差し引いたクレジットは全額返還されます
デフォルトの上限1 リクエストあたり 100,000 文字（100 クレジット）
最大の上限1 リクエストあたり 500,000 文字（500 クレジット）

クレジットは実際に抽出されたコンテンツの長さに基づいて計算されます。3,000 文字の記事は 3 クレジット（実測）、100,000 文字の記事は 100 クレジット、250,000 文字の記事は 250 クレジットです。

レート制限

制限項目値説明
作成リクエストのレート3 RPM1 分あたり最大 3 件の作成リクエスト
AI 動画生成のレート5 RPMPOST /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 を参照してください。

次のステップ

このページの内容

クレジットの概要クレジットの種類サブスクリプションプランクレジット消費量の目安コンテンツ抽出のクレジットポリシーレート制限クレジット残高を確認する次のステップ