Get speaker ID

Updated2024 年 5 月 20 日

GET

https://moyin-gateway.dupdub.com/tts/v1/storeSpeakerV2/searchSpeakerList

Parameters

Header parameters

Name	Description
dupdub_token	Your DupDub token
Content-Type	application/json

Query parameters

Name	Type	Description
language	string \| optional	General language filter: Afrikaans Arabic Chinese Croatian Czech Danish Dutch English Estonian Filipino Finnish French German Hindi Hungarian Icelandic Indonesian Irish Italian Japanese Javanese Korean Latvian Lithuanian Malay Marathi Mongolian Norwegian Polish Portuguese Romanian Russian Serbian Slovak Slovenian Spanish Swahili Swedish Tamil Thai Turkish Urdu Vietnamese Welsh
accent	string \| optional	Accent filter
gender	string \| optional	Gender filter: MALE FEMALE
vipAuth	integer \| optional	Voice quality 0: Standard 1: Premium 2: Ultra
domainId	integer \| optional	Domain ID for filtering: 1: Podcast 2: Audiobook 3: Marketing 4: Narrative 5: News 7: Explainer 8: Documentary 9: Talk Show 10: Poetry 11: Adventure 12: Entertainment 13: Fairytales
age	string	Age group filter: Children Youth Adults Seniors
emotion	string \| optional	Emotion filter: assistant chat customerservice newscast newscast-casual newscast-formal narration-professional angry cheerful sad excited friendly terrified shouting unfriendly whispering hopeful empathetic
pageSize	integer \| optional	Number of items per page
pageNum	integer \| optional	Page number for pagination

Response

Name	Type	Description
data	object	The container object for the response data.
├ totalElements	integer	Total number of voiceover actors found
├ totalEmotionCounts	integer	Total counts of different emotions
├ totalPages	integer	Total number of pages available
├ results	object [ ]	Array of speaker objects
builderId	integer	Unique identifier for the builder
speakerId	string	Unique identifier for the speaker
speaker	string	Speaker designation. Used for /v1/playDemo/dubForSpeaker
name	string	Name of the speaker
quality	integer	Voice file quality of synthesized speech
displayOrder	integer	Order in the display listing
headerImage	string	URL to the speaker's header image
tags	string	Tags associated with the speaker (e.g., hot, new)
gender	string	Gender of the speaker
age	integer	Age of the speaker
language	string	Language spoken by the speaker
accent	string	Accent of the speaker
emotionSet	string [ ]	List of emotions or styles
code	integer	Response code indicating success or failure 200: Succeed 400: Parameter validation failed 403: No relevant permissions 500: Failed 502: Gateway service exception 2001: Login failed, please login again
message	string	A message providing additional information about the response code

Sample Codes

Request

import requests

# API endpoint for query the speaker id
url = "https://moyin-gateway.dupdub.com/tts/v1/storeSpeakerV2/searchSpeakerList?language={language}&domainId={domainId}"

# Your API key
api_key = "<<Your DupDub API Key>>"

headers = {
    "dupdub_token": f"{api_key}",
    "Content-Type": "application/json"
}

response = requests.get(url.format(language="English",accent="American",domainId=13), headers=headers)

# Parse the response
if response.status_code == 200:
    result = response.json()
    print(result)
else:
    print("Failed to query voiceover actor information. Status Code:", response.status_code)

Response

{
  'code': 200,
  'message': 'OK',
  'data': {
    'totalElements': 13,
    'totalEmotionCounts': 13,
    'totalPages': 2,
    'results': [
      {
        'builderId': '2afe4567e1bf64d32a5527244d104cea',
        'speakerId': 719,
        'speaker': 'aldenwalsh_meet_24k',
        'speakerType': None,
        'name': 'Alden Walsh',
        'quality': 24000,
        'displayOrder': 3,
        'headerImage': 'https://cdn-static.dupdub.com/backend/headerImage/224_224/3f69775f50c54e298c057f4185f80637-Kelan.png',
        'playCount': '0',
        'tags': None,
        'gender': 'MALE',
        'age': 35,
        'vipAuth': 1,
        'language': 'English',
        'accent': 'American',
        'emotionSet': [
          
        ],
        'speakerFeature': [
          0,
          2,
          4,
          5,
          6,
          7,
          8,
          9,
          10,
          11,
          14,
          15,
          18
        ],
        'speakerEmotionCacheVOList': [
          {
            'speakerId': 719,
            'speaker': 'aldenwalsh_meet_24k',
            'name': 'Alden Walsh'
          }
        ],
        'favourite': False
      },
      {
        'builderId': '2f37d10131f2a483a8dd005b3d14b0d9',
        'speakerId': 658,
        'speaker': 'uranus_Gigi',
        'speakerType': None,
        'name': 'Gigi',
        'quality': 16000,
        'displayOrder': 3,
        'headerImage': 'https://cdn-static.dupdub.com/backend/headerImage/224_224/91180b53c7b940bfaab0a048080649e2-Gigi.png',
        'playCount': '0',
        'tags': None,
        'gender': 'FEMALE',
        'age': 25,
        'vipAuth': 2,
        'language': 'English',
        'accent': 'American',
        'emotionSet': [
          
        ],
        'speakerFeature': [
          2,
          4,
          6,
          7,
          9,
          10,
          11,
          14,
          15
        ],
        'speakerEmotionCacheVOList': [
          {
            'speakerId': 658,
            'speaker': 'uranus_Gigi',
            'name': 'Gigi'
          }
        ],
        'favourite': False
      },
      {
        'builderId': 'cf67355a3333e6e143439161adc2d82e',
        'speakerId': 520,
        'speaker': 'siennadoyle_meet_24k',
        'speakerType': None,
        'name': 'Sienna Doyle',
        'quality': 24000,
        'displayOrder': 50,
        'headerImage': 'https://cdn-static.dupdub.com/backend/headerImage/224_224/a4a7154344e94de2b66431e980c64ec1-SiennaDoyle@2x(1).png',
        'playCount': '236787',
        'tags': None,
        'gender': 'FEMALE',
        'age': 30,
        'vipAuth': 1,
        'language': 'English',
        'accent': 'American',
        'emotionSet': [
          
        ],
        'speakerFeature': [
          0,
          2,
          4,
          5,
          6,
          7,
          8,
          9,
          10,
          11,
          14,
          15,
          18
        ],
        'speakerEmotionCacheVOList': [
          {
            'speakerId': 520,
            'speaker': 'siennadoyle_meet_24k',
            'name': 'Sienna Doyle'
          }
        ],
        'favourite': False
      },
      {
        'builderId': 'd14220ee66aeec73c49038385428ec4c',
        'speakerId': 714,
        'speaker': 'devonealynew_meet_24k',
        'speakerType': None,
        'name': 'Devon Ealy',
        'quality': 24000,
        'displayOrder': 3,
        'headerImage': 'https://cdn-static.dupdub.com/backend/headerImage/224_224/bd37136e38564fa4af4fedd2daf7f953-Devon-Ealy.png',
        'playCount': '0',
        'tags': None,
        'gender': 'MALE',
        'age': 30,
        'vipAuth': 1,
        'language': 'English',
        'accent': 'American',
        'emotionSet': [
          
        ],
        'speakerFeature': [
          0,
          2,
          4,
          5,
          6,
          7,
          8,
          9,
          10,
          11,
          14,
          15,
          18
        ],
        'speakerEmotionCacheVOList': [
          {
            'speakerId': 714,
            'speaker': 'devonealynew_meet_24k',
            'name': 'Devon Ealy'
          }
        ],
        'favourite': False
      },
      {
        'builderId': '84117275be999ff55a987b9381e01f96',
        'speakerId': 665,
        'speaker': 'uranus_Jessie',
        'speakerType': None,
        'name': 'Norman',
        'quality': 16000,
        'displayOrder': 3,
        'headerImage': 'https://cdn-static.dupdub.com/backend/headerImage/224_224/c4f24a0b483e47d78fff672bc0b3b4c3-Domi.png',
        'playCount': '0',
        'tags': None,
        'gender': 'MALE',
        'age': 50,
        'vipAuth': 2,
        'language': 'English',
        'accent': 'American',
        'emotionSet': [
          
        ],
        'speakerFeature': [
          2,
          4,
          6,
          7,
          9,
          10,
          11,
          14,
          15
        ],
        'speakerEmotionCacheVOList': [
          {
            'speakerId': 665,
            'speaker': 'uranus_Jessie',
            'name': 'Norman'
          }
        ],
        'favourite': False
      },
      {
        'builderId': '55743cc0393b1cb4b8b37d09ae48d097',
        'speakerId': 651,
        'speaker': 'uranus_Matilda',
        'speakerType': None,
        'name': 'Matilda',
        'quality': 16000,
        'displayOrder': 3,
        'headerImage': 'https://cdn-static.dupdub.com/backend/headerImage/224_224/4807ea835044482b844b7223c883428d-Matilda.png',
        'playCount': '0',
        'tags': 'HOT',
        'gender': 'FEMALE',
        'age': 25,
        'vipAuth': 2,
        'language': 'English',
        'accent': 'American',
        'emotionSet': [
          
        ],
        'speakerFeature': [
          2,
          4,
          6,
          7,
          9,
          10,
          11,
          14,
          15
        ],
        'speakerEmotionCacheVOList': [
          {
            'speakerId': 651,
            'speaker': 'uranus_Matilda',
            'name': 'Matilda'
          }
        ],
        'favourite': False
      },
      {
        'builderId': '65ded5353c5ee48d0b7d48c591b8f430',
        'speakerId': 132,
        'speaker': 'saturn_justin_neural',
        'speakerType': None,
        'name': 'Nathan-HQ',
        'quality': 16000,
        'displayOrder': 78,
        'headerImage': 'https://cdn-static.dupdub.com/backend/headerImage/224_224/1c83a89b1d3948fab4217cb4ecc924bc-小男孩-2@2x.png',
        'playCount': '31571',
        'tags': None,
        'gender': 'MALE',
        'age': 7,
        'vipAuth': 1,
        'language': 'English',
        'accent': 'American',
        'emotionSet': [
          
        ],
        'speakerFeature': [
          0,
          2,
          18,
          4,
          5,
          6,
          7,
          9,
          10,
          11,
          14,
          15
        ],
        'speakerEmotionCacheVOList': [
          {
            'speakerId': 132,
            'speaker': 'saturn_justin_neural',
            'name': 'Nathan-HQ'
          }
        ],
        'favourite': False
      },
      {
        'builderId': '17c276c8e723eb46aef576537e9d56d0',
        'speakerId': 670,
        'speaker': 'uranus_Mimi',
        'speakerType': None,
        'name': 'Mimi',
        'quality': 16000,
        'displayOrder': 1,
        'headerImage': 'https://cdn-static.dupdub.com/backend/headerImage/224_224/1699dc9388844cd2a026959ff1f0328a-Mimi.png',
        'playCount': '0',
        'tags': 'HOT',
        'gender': 'FEMALE',
        'age': 25,
        'vipAuth': 2,
        'language': 'English',
        'accent': 'American',
        'emotionSet': [
          
        ],
        'speakerFeature': [
          2,
          4,
          6,
          7,
          9,
          10,
          11,
          14,
          15
        ],
        'speakerEmotionCacheVOList': [
          {
            'speakerId': 670,
            'speaker': 'uranus_Mimi',
            'name': 'Mimi'
          }
        ],
        'favourite': False
      },
      {
        'builderId': 'd9d4f495e875a2e075a1a4a6e1b9770f',
        'speakerId': 46,
        'speaker': 'mercury_ana',
        'speakerType': None,
        'name': 'Angela Adkins',
        'quality': 16000,
        'displayOrder': 15,
        'headerImage': 'https://cdn-static.dupdub.com/backend/headerImage/224_224/95d88bedee2d4fbdbbff3c1f296cc341-小女孩-2@2x.png',
        'playCount': '274533',
        'tags': None,
        'gender': 'FEMALE',
        'age': 9,
        'vipAuth': 1,
        'language': 'English',
        'accent': 'American',
        'emotionSet': [
          
        ],
        'speakerFeature': [
          0,
          2,
          4,
          5,
          6,
          7,
          8,
          9,
          10,
          11,
          14,
          15,
          18
        ],
        'speakerEmotionCacheVOList': [
          {
            'speakerId': 46,
            'speaker': 'mercury_ana',
            'name': 'Angela Adkins'
          }
        ],
        'favourite': False
      },
      {
        'builderId': 'c5ab0bc60ac7929182aadd08703f1ec6',
        'speakerId': 636,
        'speaker': 'uranus_Fin',
        'speakerType': None,
        'name': 'Fin',
        'quality': 16000,
        'displayOrder': 3,
        'headerImage': 'https://cdn-static.dupdub.com/backend/headerImage/224_224/d83a885cea8d4e38b82ac8ede868cea1-Fin.png',
        'playCount': '0',
        'tags': None,
        'gender': 'MALE',
        'age': 40,
        'vipAuth': 2,
        'language': 'English',
        'accent': 'American',
        'emotionSet': [
          
        ],
        'speakerFeature': [
          2,
          4,
          6,
          7,
          9,
          10,
          11,
          14,
          15
        ],
        'speakerEmotionCacheVOList': [
          {
            'speakerId': 636,
            'speaker': 'uranus_Fin',
            'name': 'Fin'
          }
        ],
        'favourite': False
      }
    ]
  }
}

Table of Contents