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. The endpoint returns both your private (cloned) voices and the public catalog. Filter by language to narrow the list to a single locale.

Query parameters:

Parameter	Type	Required	Description
`language`	string	No	Filter by language code, e.g. `en`, `zh`, `ja`. Omit to return speakers in all languages.
`status`	integer	No	Catalog status filter. `3` returns published speakers (default), `1` returns active speakers.

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:

Field	Type	Description
`name`	string	Display name of the speaker
`speakerId`	string	Unique identifier, used when creating content
`demoAudioUrl`	string	URL to the speaker's demo audio
`gender`	string	`"male"` or `"female"`
`language`	string	Language code, e.g. `"en"`, `"zh"`
`profile`	object	Voice profile describing the listening experience
`profile.pitch`	string[]	Pitch range, e.g. `["medium-high"]`
`profile.speed`	string[]	Speaking speed, e.g. `["medium-fast"]`
`profile.traits`	string[]	Voice characteristics, e.g. `["clear", "bright"]`
`profile.styles`	string[]	Emotional styles, e.g. `["professional", "friendly"]`
`profile.scenes`	string[]	Recommended use cases, e.g. `["podcast", "narration"]`
`profile.accent`	string	Accent description, e.g. `"American English"`
`profile.description`	string	Overall voice description in English
`profile.descriptionLocalized`	object	Localized 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:

Speaker	ID	Gender	Description
Mia	`travel-girl-english`	Female	A clear, bright voice at a moderately fast pace with a warm, friendly narration style, suitable for various narration and audio content.
Leo	`leo-9328b6d2`	Male	A clear, bright young male voice with a slight nasal quality, suitable for conversational content like podcasts, vlogs, and presentations.
Marcus	`Marcus-9aa6846b`	Male	A clear, bright, and energetic male voice, ideal for creating engaging podcasts and professional narration.
Aoede	`en-us-chirp3-hd-aoede-72845d1a`	Female	A clear, bright female voice at a moderate pace with a calm, elegant narrative style, suitable for audiobooks and documentary narration.
David	`lowman-51dbcc05`	Male	A clear, steady male voice that is professional and confident, suitable for business presentations, knowledge sharing, and narration.
Reed	`lowwoman-687103f5`	Female	A clear, professional, and confident voice, suitable for business presentations, news broadcasts, and educational content, conveying authority and composure.
Sarah	`middlewoman-3731593b`	Female	Clear and bright with a moderate pace, full of energy, suitable for professional settings like podcasts, business presentations, and teaching.
Ashley	`Ashley-f5de473a`	Female	A clear, bright, and energetic voice, perfect for sharing life experiences and friendly conversations.
Leda	`en-us-chirp3-hd-leda-e801b185`	Female	Clear and soft with a moderate pace, mellow and steady tone, suitable for audiobooks and documentary narration.
Mars	`cozy-man-english`	Male	A clear, steady, and magnetic voice, suitable for podcast narration, documentary commentary, and various professional content.
Catherine	`catherine-fd3c96a2`	Female	A clear, steady female voice with warm tones, full of confidence and guidance, suitable for business presentations, knowledge sharing, and narration.
Arthur	`arthur-2ae006aa`	Male	A clear, confident, and professional male voice with medium-low pitch and moderately fast pace, ideal for business, news, and documentary narration.
Iris	`famalepodcastemmawatsonrp-e0342a5a`	Female	A clear, warm female voice at a moderate pace, full of approachability, suitable for audiobooks and customer service.
Host Maya	`livefemale2-778526f2`	Female	A clear, bright, and energetic female voice with a friendly, approachable tone, suitable for podcasts, explainers, and promotional content.
Host Sam	`hostsam-dab52696`	Male	A clear, bright male voice at a moderately fast pace, full of energy and enthusiasm, suitable for podcasts, travel vlogs, and casual narration.
Host John	`livemale-576eef6f`	Male	An energetic and enthusiastic male voice, ideal for game streaming and esports commentary.
Host Claire	`livefemale-cc42c5bf`	Female	A clear, bright, and energetic female voice with a warm, friendly style, suitable for live streaming, podcasts, and welcome speeches.
Meditation Nate	`midnightnate-e48a5b5f`	Male	A deep, soft, and magnetic male voice at a slow pace, ideal for guiding meditation, sleep aid, and deep relaxation.
Meditation Kate	`minight-kate-d4b925d0`	Female	A soft, warm female voice at a slow pace, suitable for meditation, sleep aid, and guided relaxation.
Story Pixie	`storypixie-e70ddb42`	Male	A clear, bright, and charming voice, perfect for telling fantasy stories and children's content.
Storyteller Finn	`vividstoryteachermale-8a369b48`	Male	A clear, warm male voice at a moderate pace with a magnetic quality, suitable for telling mysterious and engaging stories.
Eliot (ASMR)	`ASMR-Male-EN`	Male	A 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-v3`	Female	A soft, calm, breathy voice at a slow pace, suitable for ASMR, bedtime stories, and meditation, providing a soothing and relaxing experience.
Charon	`en-us-chirp3-hd-charon-9f952104`	Male	A deep, magnetic voice with a steady pace, full of mystery and narrative quality, suitable for horror, suspense narration, or audiobooks.
Orus	`es-es-chirp3-hd-orus-3941b176`	Male	A steady, magnetic male voice at a moderately fast pace with clear pronunciation, suitable for history, science, and educational narration or audiobooks.
Noah	`malechrishemsworthpodcastaus-723dad64`	Male	A warm, mellow voice at a moderate pace, suitable for various professional broadcasts and communication scenarios.
Michael	`English-Gentle-voiced-man`	Male	A clear, steady, and professional male voice, suitable for business presentations, podcasts, and various educational training content.
Daniel	`Daniel`	Male	A clear, steady, and professional male voice, suitable for knowledge sharing, business presentations, and news broadcasts.
Olivia	`English-compelling-lady1`	Female	A clear, warm female voice suitable for narration and professional content.
Owen	`English-GentleTeacher`	Male	A clear, steady male voice with a magnetic and professional quality at a moderate pace, suitable for documentary narration, corporate videos, and news broadcasts.

List Available Speakers

Voice Preview

On this page