ListenHubOpenAPI
API リファレンス

話者

クローンした話者を含む利用可能なすべてのボイスを取得し、ポッドキャストやテキスト読み上げなどの生成 API で使用します。

利用可能な話者を一覧する

GET /v1/speakers/list

コンテンツ生成に使える話者を、クローンしたボイスも含めてすべて取得します。このエンドポイントは、あなたのプライベート（クローン）ボイスと公開カタログの両方を返します。language で絞り込むと、単一のロケールだけに一覧を限定できます。

クローンしたボイスを返すのはこのエンドポイントだけで、API キーが必要です。公開カタログだけでよい場合 — 耳で聴いてボイスを選ぶ、あるいはエージェントに一覧をまとめて渡す — であれば、listenhub.ai/voices.txt が認証なしで公式ボイス全件をプレーンテキストで返し、listenhub.ai/voices は同じカタログを試聴つきで提供します。

クエリパラメータ：

パラメータ型必須説明
languagestringいいえ言語コードで絞り込みます（例：en、zh、ja）。省略するとすべての言語の話者を返します。
statusintegerいいえカタログのステータスフィルタ。3 は公開済みの話者（デフォルト）、1 は有効な話者を返します。

リクエスト例：

# List Chinese speakers
curl -X GET "https://api.marswave.ai/openapi/v1/speakers/list?language=zh" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY"

# List English speakers
curl -X GET "https://api.marswave.ai/openapi/v1/speakers/list?language=en" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY"
const response = await fetch('https://api.marswave.ai/openapi/v1/speakers/list?language=en', {
  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/speakers/list',
    headers={'Authorization': f'Bearer {os.environ["LISTENHUB_API_KEY"]}'},
    params={'language': 'en'}
)
data = response.json()
print(data)

レスポンス例：

{
  "code": 0,
  "message": "",
  "data": {
    "items": [
      {
        "name": "Marcus",
        "speakerId": "Marcus-9aa6846b",
        "demoAudioUrl": "https://assets.listenhub.ai/listenhub-public-prod/audios/Marcus-9aa6846b_demo_audio.mp3",
        "gender": "male",
        "language": "en",
        "profile": {
          "pitch": ["medium-high"],
          "speed": ["medium-fast"],
          "traits": ["clear", "bright", "friendly", "fluent"],
          "styles": ["professional", "friendly", "energetic"],
          "scenes": ["podcast", "narration", "advertising"],
          "accent": "American English",
          "description": "A clear, bright, and energetic male voice, ideal for creating engaging podcasts and professional narration.",
          "descriptionLocalized": {
            "zh": "清晰明亮、充满活力的男声，适合制作引人入胜的播客和专业旁白。",
            "en": "A clear, bright, and energetic male voice, ideal for creating engaging podcasts and professional narration."
          }
        }
      }
    ]
  }
}

レスポンスフィールド：

フィールド型説明
namestring話者の表示名
speakerIdstring一意の識別子。コンテンツ作成時に使用します
demoAudioUrlstring話者のデモ音声の URL
genderstring"male" または "female"
languagestring言語コード（例："en"、"zh"）
profileobject聴いた印象を表すボイスプロファイル
profile.pitchstring[]音程の範囲（例：["medium-high"]）
profile.speedstring[]話す速さ（例：["medium-fast"]）
profile.traitsstring[]声の特徴（例：["clear", "bright"]）
profile.stylesstring[]感情のスタイル（例：["professional", "friendly"]）
profile.scenesstring[]推奨する用途（例：["podcast", "narration"]）
profile.accentstringアクセントの説明（例："American English"）
profile.descriptionstring英語による声の総合的な説明
profile.descriptionLocalizedobject言語コードをキーとするローカライズ済みの説明

ボイスの試聴

API レスポンスの demoAudioUrl フィールドには、各話者のデモ音声への直接リンクが入ります。コンテンツ生成用のボイスを選ぶ前に、ユーザーが試聴できるようにするために利用できます。

利用可能な英語ボイス一覧：

話者ID性別説明試聴
Miatravel-girl-english女性明瞭で明るい声。やや速めのテンポと温かくフレンドリーな語り口で、さまざまなナレーションや音声コンテンツに適しています。
Leoleo-9328b6d2男性明瞭で明るい若い男性の声。わずかに鼻にかかった質感があり、ポッドキャストや vlog、プレゼンテーションなどの会話調のコンテンツに適しています。
MarcusMarcus-9aa6846b男性明瞭で明るく、活力のある男性の声。引き込まれるポッドキャストやプロフェッショナルなナレーションの制作に最適です。
Aoedeen-us-chirp3-hd-aoede-72845d1a女性明瞭で明るい女性の声。標準的なテンポと落ち着いた上品な語り口で、オーディオブックやドキュメンタリーのナレーションに適しています。
Davidlowman-51dbcc05男性明瞭で落ち着いた男性の声。プロフェッショナルで自信のある響きがあり、ビジネスプレゼン、知識共有、ナレーションに適しています。
Reedlowwoman-687103f5女性明瞭でプロフェッショナル、かつ自信のある声。ビジネスプレゼン、ニュース放送、教育コンテンツに適しており、権威と落ち着きを伝えます。
Sarahmiddlewoman-3731593b女性明瞭で明るく、標準的なテンポでエネルギーにあふれた声。ポッドキャスト、ビジネスプレゼン、講義などのプロフェッショナルな場面に適しています。
AshleyAshley-f5de473a女性明瞭で明るく、活力のある声。日常の体験談やフレンドリーな会話にぴったりです。
Ledaen-us-chirp3-hd-leda-e801b185女性明瞭で柔らかく、標準的なテンポ。まろやかで安定したトーンで、オーディオブックやドキュメンタリーのナレーションに適しています。
Marscozy-man-english男性明瞭で落ち着いた、魅力的な声。ポッドキャストのナレーション、ドキュメンタリーの解説、各種プロフェッショナルなコンテンツに適しています。
Catherinecatherine-fd3c96a2女性明瞭で落ち着いた女性の声。温かみのあるトーンで自信と導きに満ち、ビジネスプレゼン、知識共有、ナレーションに適しています。
Arthurarthur-2ae006aa男性明瞭で自信に満ちたプロフェッショナルな男性の声。やや低めの音程とやや速めのテンポで、ビジネス、ニュース、ドキュメンタリーのナレーションに最適です。
Irisfamalepodcastemmawatsonrp-e0342a5a女性明瞭で温かみのある女性の声。標準的なテンポで親しみやすく、オーディオブックやカスタマーサービスに適しています。
Host Mayalivefemale2-778526f2女性明瞭で明るく、活力のある女性の声。フレンドリーで親しみやすいトーンで、ポッドキャスト、解説コンテンツ、プロモーションに適しています。
Host Samhostsam-dab52696男性明瞭で明るい男性の声。やや速めのテンポでエネルギーと熱意にあふれ、ポッドキャスト、旅行 vlog、カジュアルなナレーションに適しています。
Host Johnlivemale-576eef6f男性活力と熱意にあふれた男性の声。ゲーム配信や e スポーツの実況に最適です。
Host Clairelivefemale-cc42c5bf女性明瞭で明るく、活力のある女性の声。温かくフレンドリーなスタイルで、ライブ配信、ポッドキャスト、歓迎の挨拶に適しています。
Meditation Natemidnightnate-e48a5b5f男性深く柔らかで魅力的な男性の声。ゆっくりとしたテンポで、瞑想の誘導、入眠サポート、深いリラクゼーションに最適です。
Meditation Kateminight-kate-d4b925d0女性柔らかく温かみのある女性の声。ゆっくりとしたテンポで、瞑想、入眠サポート、リラクゼーションの誘導に適しています。
Story Pixiestorypixie-e70ddb42男性明瞭で明るく、愛らしい声。ファンタジーの物語や子ども向けコンテンツの語りにぴったりです。
Storyteller Finnvividstoryteachermale-8a369b48男性明瞭で温かみのある男性の声。標準的なテンポと魅力的な質感で、神秘的で引き込まれる物語の語りに適しています。
Eliot (ASMR)ASMR-Male-EN男性深く魅力的で、吐息まじりの男性の声。ゆっくりと穏やかなテンポで、ASMR による入眠サポート、瞑想、リラクゼーションに最適。この上ない静けさと心地よさを届けます。
Lily (ASMR)English-Whispering-girl-v3女性柔らかく穏やかで、吐息まじりの声。ゆっくりとしたテンポで、ASMR、おやすみ前の物語、瞑想に適しており、癒やしとリラックスの体験を届けます。
Charonen-us-chirp3-hd-charon-9f952104男性深く魅力的な声。安定したテンポで神秘性と語りの質感にあふれ、ホラーやサスペンスのナレーション、オーディオブックに適しています。
Oruses-es-chirp3-hd-orus-3941b176男性落ち着いた魅力的な男性の声。やや速めのテンポと明瞭な発音で、歴史・科学・教育のナレーションやオーディオブックに適しています。
Noahmalechrishemsworthpodcastaus-723dad64男性温かくまろやかな声。標準的なテンポで、さまざまなプロフェッショナルな放送やコミュニケーションの場面に適しています。
MichaelEnglish-Gentle-voiced-man男性明瞭で落ち着いた、プロフェッショナルな男性の声。ビジネスプレゼン、ポッドキャスト、各種の教育・研修コンテンツに適しています。
DanielDaniel男性明瞭で落ち着いた、プロフェッショナルな男性の声。知識共有、ビジネスプレゼン、ニュース放送に適しています。
OliviaEnglish-compelling-lady1女性明瞭で温かみのある女性の声。ナレーションやプロフェッショナルなコンテンツに適しています。
OwenEnglish-GentleTeacher男性明瞭で落ち着いた男性の声。標準的なテンポで魅力的かつプロフェッショナルな質感があり、ドキュメンタリーのナレーション、企業向け動画、ニュース放送に適しています。

このページの内容

利用可能な話者を一覧するボイスの試聴