화자 - ListenHub OpenAPI

클론 화자를 포함해 사용 가능한 모든 보이스를 가져와 팟캐스트, 텍스트 음성 변환 등 생성 API에서 사용합니다.

사용 가능한 화자 목록 조회

GET /v1/speakers/list

콘텐츠 생성에 사용할 수 있는 모든 화자를 클론 보이스까지 포함해 가져옵니다. 이 엔드포인트는 내 비공개(클론) 보이스와 공개 카탈로그를 함께 반환합니다. language로 필터링하면 특정 언어로 목록을 좁힐 수 있습니다.

클론 보이스를 반환하는 엔드포인트는 이것뿐이며, API key가 필요합니다. 공개 카탈로그만 필요하다면 — 귀로 들어보고 보이스를 고르거나, 전체 목록을 한 번의 요청으로 agent에게 넘기려는 경우 — listenhub.ai/voices.txt가 인증 없이 모든 공식 보이스를 일반 텍스트로 제공하고, listenhub.ai/voices는 같은 카탈로그를 오디오 미리듣기와 함께 보여줍니다.

쿼리 파라미터:

파라미터	타입	필수	설명
`language`	string	아니요	언어 코드로 필터링(예: `en`, `zh`, `ja`). 생략하면 모든 언어의 화자를 반환합니다.
`status`	integer	아니요	카탈로그 상태 필터. `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."
          }
        }
      }
    ]
  }
}

응답 필드:

필드	타입	설명
`name`	string	화자의 표시 이름
`speakerId`	string	고유 식별자. 콘텐츠 생성 시 사용
`demoAudioUrl`	string	화자의 데모 오디오 URL
`gender`	string	`"male"` 또는 `"female"`
`language`	string	언어 코드(예: `"en"`, `"zh"`)
`profile`	object	청취 경험을 설명하는 보이스 프로필
`profile.pitch`	string[]	음역대(예: `["medium-high"]`)
`profile.speed`	string[]	말하기 속도(예: `["medium-fast"]`)
`profile.traits`	string[]	음색 특성(예: `["clear", "bright"]`)
`profile.styles`	string[]	감정 스타일(예: `["professional", "friendly"]`)
`profile.scenes`	string[]	권장 사용 사례(예: `["podcast", "narration"]`)
`profile.accent`	string	억양 설명(예: `"American English"`)
`profile.description`	string	영어로 된 전체 보이스 설명
`profile.descriptionLocalized`	object	언어 코드를 키로 하는 현지화된 설명

보이스 미리듣기

API 응답의 demoAudioUrl 필드는 각 화자의 데모 오디오로 바로 연결되는 링크를 제공합니다. 사용자가 콘텐츠 생성에 쓸 보이스를 고르기 전에 미리 들어볼 수 있도록 활용할 수 있습니다.

사용 가능한 영어 보이스 전체 목록:

화자	ID	성별	설명
Mia	`travel-girl-english`	여성	명료하고 밝은 보이스. 다소 빠른 속도와 따뜻하고 친근한 내레이션 스타일로, 다양한 내레이션과 오디오 콘텐츠에 적합합니다.
Leo	`leo-9328b6d2`	남성	명료하고 밝은 젊은 남성 보이스. 약간의 비음이 섞여 있어 팟캐스트, 브이로그, 프레젠테이션 같은 대화형 콘텐츠에 적합합니다.
Marcus	`Marcus-9aa6846b`	남성	명료하고 밝으며 활기찬 남성 보이스. 몰입감 있는 팟캐스트와 전문적인 내레이션 제작에 최적입니다.
Aoede	`en-us-chirp3-hd-aoede-72845d1a`	여성	명료하고 밝은 여성 보이스. 보통 속도와 차분하고 우아한 서술 스타일로, 오디오북과 다큐멘터리 내레이션에 적합합니다.
David	`lowman-51dbcc05`	남성	명료하고 안정적인 남성 보이스. 전문적이고 자신감 있는 느낌으로, 비즈니스 프레젠테이션, 지식 공유, 내레이션에 적합합니다.
Reed	`lowwoman-687103f5`	여성	명료하고 전문적이며 자신감 있는 보이스. 비즈니스 프레젠테이션, 뉴스 방송, 교육 콘텐츠에 적합하며 권위와 침착함을 전달합니다.
Sarah	`middlewoman-3731593b`	여성	명료하고 밝으며 보통 속도로 에너지가 넘치는 보이스. 팟캐스트, 비즈니스 프레젠테이션, 강의 같은 전문적인 상황에 적합합니다.
Ashley	`Ashley-f5de473a`	여성	명료하고 밝으며 활기찬 보이스. 일상 경험 공유와 친근한 대화에 잘 어울립니다.
Leda	`en-us-chirp3-hd-leda-e801b185`	여성	명료하고 부드러우며 보통 속도. 원숙하고 안정적인 톤으로 오디오북과 다큐멘터리 내레이션에 적합합니다.
Mars	`cozy-man-english`	남성	명료하고 안정적이며 매력적인 보이스. 팟캐스트 내레이션, 다큐멘터리 해설, 다양한 전문 콘텐츠에 적합합니다.
Catherine	`catherine-fd3c96a2`	여성	명료하고 안정적인 여성 보이스. 따뜻한 톤에 자신감과 이끄는 힘이 있어 비즈니스 프레젠테이션, 지식 공유, 내레이션에 적합합니다.
Arthur	`arthur-2ae006aa`	남성	명료하고 자신감 있는 전문적인 남성 보이스. 중저음에 다소 빠른 속도로, 비즈니스, 뉴스, 다큐멘터리 내레이션에 최적입니다.
Iris	`famalepodcastemmawatsonrp-e0342a5a`	여성	명료하고 따뜻한 여성 보이스. 보통 속도에 친근함이 가득해 오디오북과 고객 응대에 적합합니다.
Host Maya	`livefemale2-778526f2`	여성	명료하고 밝으며 활기찬 여성 보이스. 친근하고 다가가기 쉬운 톤으로 팟캐스트, 설명 콘텐츠, 홍보 콘텐츠에 적합합니다.
Host Sam	`hostsam-dab52696`	남성	명료하고 밝은 남성 보이스. 다소 빠른 속도에 에너지와 열정이 넘쳐 팟캐스트, 여행 브이로그, 캐주얼한 내레이션에 적합합니다.
Host John	`livemale-576eef6f`	남성	에너지와 열정이 넘치는 남성 보이스. 게임 스트리밍과 e스포츠 중계에 최적입니다.
Host Claire	`livefemale-cc42c5bf`	여성	명료하고 밝으며 활기찬 여성 보이스. 따뜻하고 친근한 스타일로 라이브 방송, 팟캐스트, 환영 인사에 적합합니다.
Meditation Nate	`midnightnate-e48a5b5f`	남성	깊고 부드러우며 매력적인 남성 보이스. 느린 속도로 명상 유도, 수면 유도, 깊은 이완에 최적입니다.
Meditation Kate	`minight-kate-d4b925d0`	여성	부드럽고 따뜻한 여성 보이스. 느린 속도로 명상, 수면 유도, 이완 가이드에 적합합니다.
Story Pixie	`storypixie-e70ddb42`	남성	명료하고 밝으며 사랑스러운 보이스. 판타지 이야기와 어린이 콘텐츠를 들려주기에 잘 어울립니다.
Storyteller Finn	`vividstoryteachermale-8a369b48`	남성	명료하고 따뜻한 남성 보이스. 보통 속도에 매력적인 울림이 있어 신비롭고 몰입감 있는 이야기를 들려주기에 적합합니다.
Eliot (ASMR)	`ASMR-Male-EN`	남성	깊고 매력적이며 숨결이 섞인 남성 보이스. 느리고 부드러운 속도로 ASMR 수면 유도, 명상, 이완에 최적이며 최상의 평온함과 편안함을 전합니다.
Lily (ASMR)	`English-Whispering-girl-v3`	여성	부드럽고 차분하며 숨결이 섞인 보이스. 느린 속도로 ASMR, 잠자리 동화, 명상에 적합하며 편안하고 이완되는 경험을 제공합니다.
Charon	`en-us-chirp3-hd-charon-9f952104`	남성	깊고 매력적인 보이스. 안정적인 속도에 신비로움과 서사적인 느낌이 가득해 공포, 서스펜스 내레이션이나 오디오북에 적합합니다.
Orus	`es-es-chirp3-hd-orus-3941b176`	남성	안정적이고 매력적인 남성 보이스. 다소 빠른 속도에 발음이 또렷해 역사, 과학, 교육 내레이션이나 오디오북에 적합합니다.
Noah	`malechrishemsworthpodcastaus-723dad64`	남성	따뜻하고 원숙한 보이스. 보통 속도로 다양한 전문 방송과 커뮤니케이션 상황에 적합합니다.
Michael	`English-Gentle-voiced-man`	남성	명료하고 안정적이며 전문적인 남성 보이스. 비즈니스 프레젠테이션, 팟캐스트, 다양한 교육·연수 콘텐츠에 적합합니다.
Daniel	`Daniel`	남성	명료하고 안정적이며 전문적인 남성 보이스. 지식 공유, 비즈니스 프레젠테이션, 뉴스 방송에 적합합니다.
Olivia	`English-compelling-lady1`	여성	명료하고 따뜻한 여성 보이스. 내레이션과 전문 콘텐츠에 적합합니다.
Owen	`English-GentleTeacher`	남성	명료하고 안정적인 남성 보이스. 매력적이고 전문적인 울림에 보통 속도로, 다큐멘터리 내레이션, 기업 영상, 뉴스 방송에 적합합니다.

화자

사용 가능한 화자 목록 조회

보이스 미리듣기

이 페이지의 내용