ListenHubOpenAPI
EN中文
API Reference

Speakers

Retrieve all available voices including cloned speakers for use in Podcast, Text to Speech, and other generation APIs.

List Available Speakers

GET /v1/speakers/list

Retrieve all available speakers, including cloned voices, for content generation.

Request examples:

# 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)

Response example:

{
  "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."
          }
        }
      }
    ]
  }
}

Response fields:

FieldTypeDescription
namestringDisplay name of the speaker
speakerIdstringUnique identifier, used when creating content
demoAudioUrlstringURL to the speaker's demo audio
genderstring"male" or "female"
languagestringLanguage code, e.g. "en", "zh"
profileobjectVoice profile describing the listening experience
profile.pitchstring[]Pitch range, e.g. ["medium-high"]
profile.speedstring[]Speaking speed, e.g. ["medium-fast"]
profile.traitsstring[]Voice characteristics, e.g. ["clear", "bright"]
profile.stylesstring[]Emotional styles, e.g. ["professional", "friendly"]
profile.scenesstring[]Recommended use cases, e.g. ["podcast", "narration"]
profile.accentstringAccent description, e.g. "American English"
profile.descriptionstringOverall voice description in English
profile.descriptionLocalizedobjectLocalized descriptions keyed by language code

Voice Preview

The demoAudioUrl field in the API response provides a direct link to each speaker's demo audio. You can use it to let your users preview a voice before selecting it for content generation.

All available English voices:

SpeakerIDGenderDescriptionPreview
Miatravel-girl-englishFemaleA clear, bright voice at a moderately fast pace with a warm, friendly narration style, suitable for various narration and audio content.
Leoleo-9328b6d2MaleA clear, bright young male voice with a slight nasal quality, suitable for conversational content like podcasts, vlogs, and presentations.
MarcusMarcus-9aa6846bMaleA clear, bright, and energetic male voice, ideal for creating engaging podcasts and professional narration.
Aoedeen-us-chirp3-hd-aoede-72845d1aFemaleA clear, bright female voice at a moderate pace with a calm, elegant narrative style, suitable for audiobooks and documentary narration.
Davidlowman-51dbcc05MaleA clear, steady male voice that is professional and confident, suitable for business presentations, knowledge sharing, and narration.
Reedlowwoman-687103f5FemaleA clear, professional, and confident voice, suitable for business presentations, news broadcasts, and educational content, conveying authority and composure.
Sarahmiddlewoman-3731593bFemaleClear and bright with a moderate pace, full of energy, suitable for professional settings like podcasts, business presentations, and teaching.
AshleyAshley-f5de473aFemaleA clear, bright, and energetic voice, perfect for sharing life experiences and friendly conversations.
Ledaen-us-chirp3-hd-leda-e801b185FemaleClear and soft with a moderate pace, mellow and steady tone, suitable for audiobooks and documentary narration.
Marscozy-man-englishMaleA clear, steady, and magnetic voice, suitable for podcast narration, documentary commentary, and various professional content.
Catherinecatherine-fd3c96a2FemaleA clear, steady female voice with warm tones, full of confidence and guidance, suitable for business presentations, knowledge sharing, and narration.
Arthurarthur-2ae006aaMaleA clear, confident, and professional male voice with medium-low pitch and moderately fast pace, ideal for business, news, and documentary narration.
Irisfamalepodcastemmawatsonrp-e0342a5aFemaleA clear, warm female voice at a moderate pace, full of approachability, suitable for audiobooks and customer service.
Host Mayalivefemale2-778526f2FemaleA clear, bright, and energetic female voice with a friendly, approachable tone, suitable for podcasts, explainers, and promotional content.
Host Samhostsam-dab52696MaleA clear, bright male voice at a moderately fast pace, full of energy and enthusiasm, suitable for podcasts, travel vlogs, and casual narration.
Host Johnlivemale-576eef6fMaleAn energetic and enthusiastic male voice, ideal for game streaming and esports commentary.
Host Clairelivefemale-cc42c5bfFemaleA clear, bright, and energetic female voice with a warm, friendly style, suitable for live streaming, podcasts, and welcome speeches.
Meditation Natemidnightnate-e48a5b5fMaleA deep, soft, and magnetic male voice at a slow pace, ideal for guiding meditation, sleep aid, and deep relaxation.
Meditation Kateminight-kate-d4b925d0FemaleA soft, warm female voice at a slow pace, suitable for meditation, sleep aid, and guided relaxation.
Story Pixiestorypixie-e70ddb42MaleA clear, bright, and charming voice, perfect for telling fantasy stories and children's content.
Storyteller Finnvividstoryteachermale-8a369b48MaleA clear, warm male voice at a moderate pace with a magnetic quality, suitable for telling mysterious and engaging stories.
Eliot (ASMR)ASMR-Male-ENMaleA deep, magnetic, breathy male voice at a slow, gentle pace, ideal for ASMR sleep aid, meditation, and relaxation, delivering ultimate calm and comfort.
Lily (ASMR)English-Whispering-girl-v3FemaleA soft, calm, breathy voice at a slow pace, suitable for ASMR, bedtime stories, and meditation, providing a soothing and relaxing experience.
Charonen-us-chirp3-hd-charon-9f952104MaleA deep, magnetic voice with a steady pace, full of mystery and narrative quality, suitable for horror, suspense narration, or audiobooks.
Oruses-es-chirp3-hd-orus-3941b176MaleA steady, magnetic male voice at a moderately fast pace with clear pronunciation, suitable for history, science, and educational narration or audiobooks.
Noahmalechrishemsworthpodcastaus-723dad64MaleA warm, mellow voice at a moderate pace, suitable for various professional broadcasts and communication scenarios.
MichaelEnglish-Gentle-voiced-manMaleA clear, steady, and professional male voice, suitable for business presentations, podcasts, and various educational training content.
DanielDanielMaleA clear, steady, and professional male voice, suitable for knowledge sharing, business presentations, and news broadcasts.
OliviaEnglish-compelling-lady1FemaleA clear, warm female voice suitable for narration and professional content.
OwenEnglish-GentleTeacherMaleA clear, steady male voice with a magnetic and professional quality at a moderate pace, suitable for documentary narration, corporate videos, and news broadcasts.

On this page

List Available SpeakersVoice Preview