Query Voices

Request URL

GET {base_url}/uc-ai/api/v1/voices

Request parameters

Headers


Parameter	Required	Type	Description
Authorization	Yes	String	The access token used for authentication. Format: Bearer `{access_token}`.
x-tenant-code	Yes	String	The tenant name. Note: You can obtain tenant name using the Query Tenants interface.

Query parameters


Parameter	Required	Type	Description
language	No	String	The language code used to filter the voices. You can obtain the value using the Query Languages interface.
accentId	No	String	The accent ID used to filter the voices, which must be a numeric string. You can obtain the value using the Query Accents interface. When this parameter is specified, it takes precedence over language.

Response parameters


Parameter	Type	Description
requestId	String	The unique ID of the request, which can be used to quickly locate the request.
code	String	The HTTP status code of the request. `200`: Request succeeded. Non-200 value: Request failed.
message	String	The status message of the request.
detailMessage	String	The detailed error information. When the request is successful, this parameter returns empty.
result	Array<Voice>	The list of voices.

Voice


Parameter	Type	Description
id	String	The ID of the voice.
name	String	The name of the voice.
accentId	String	The ID of the accent of the voice.
languages	Array<String>	The list of language codes that the voice supports.
description	String	The description of the voice.
isFallback	Boolean	Whether the voice is a fallback voice.
gender	String	The gender of the voice: `MALE` `FEMALE`
avatarUrl	String	The URL of the voice avatar.

Example

Request example

GET /uc-ai/api/v1/voices HTTP/1.1
Host: api.cn.novoone.com
Authorization: Bearer eyJraWQiOiJjbi0wLWtleS0xIiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiJkaXN0cmlidXRvcmV4YW1wbGVAb3V0bG9vay5jb20iLCJhcHBfa2V5Ijoic2xOdnQzaHc1NXB2Vm5HRlNhR2ZOVTNmMWxYQ3lpa08iLCJncmFudF90eXBlIjoib3BlbmFwaSIsImNsaWVudF9leHQiOnsiZGVzY3JpcHRpb24iOiLnrKzkuInmlrnlkIjkvZzkvJnkvLTlupTnlKgiLCJwYXJ0bmVyIjoi56S65L6L5ZCI5L2c5LyZ5Ly0In0sImNsaWVudF90eXBlIjoib3BlbmFwaSIsImV4cCI6MTc5MjU4MzY1MSwiaWF0IjoxNzkyNTYyMDUxLCJqdGkiOiI5ODRiZjY0Mi00YWNlLTRiZWEtOTk3YS1lNmVhMjVjMTc3NDYiLCJjbGllbnRfaWQiOiJub3ZvLW9wZW4tcGxhdGZvcm0iLCJ1c2VyX2V4dCI6eyJyb2xlSWRzIjpbM10sInN0eXBlIjoiQURNSU4iLCJ0ZW5hbnRDb2RlIjpudWxsLCJ0eXBlIjoiUF9BQ0NPVU5UIiwidXNlcklkIjozMDc2OTEzNjQ0OTE1OTk4NzIwLCJlbWFpbCI6ImRpc3RyaWJ1dG9yZXhhbXBsZUBvdXRsb29rLmNvbSIsInVzZXJuYW1lIjoiZGlzdHJpYnV0b3JleGFtcGxlQG91dGxvb2suY29tIiwidWNJZCI6MzA3NjkxMzY0NDg5MDgzMjg5Nn19.G2oipgaRjD1M48lPlOjh51mu3Iad7TF4PjFqGpZV8qar5rOq362P0tnF1U8U1HtqHfaIBiyPBJHjt6HVIanxps31_WI9aVw6Uyq4uRL2G3trENCeU8Now78Buvv_frAhxW8KTLiCtT2cNYC3Usn0FCv5H-jMAS4JueCb96nu60usm8V6ytMk7O0i5Bs-cqMwEmQBL75oy4vW70HtCgZrsW0ZCChdi9l5l-OtfnEgLTC1ohfSw592heykBkhCKgFM5RtXW7NFMRWRgtI3E7hdMd-ETIL2TIC-SHL17kRkku6qAzDIMDHro5XkBgccKJkGF2GXHcGgL6-dLgi9SFjrDw
x-tenant-code: jint

Response example

HTTP/1.1 200 OK
{
  "result": [
    {
      "id": "1000000000000000021",
      "name": "Arabella",
      "accentId": "1000000000000000103",
      "description": "A young engaging female voice, enchanting and compelling with every word.",
      "isFallback": true,
      "gender": "FEMALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/Arabella.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/user/rXPvBAYLgtWWSz1trBzQCzJldqC2/voices/aEO01A4wXwd1O8GPgGlF/B0TnT9nA9kj4OFUzZ3BQ.mp3"
    },
    {
      "id": "1000000000000000015",
      "name": "Archer",
      "accentId": "1000000000000000102",
      "description": "Fine tuned for conversation and podcasts etc, English, casual, thirties.",
      "isFallback": true,
      "gender": "MALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/Archer.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/workspace/b74d906ca49b4cae8711d6f8e3ba2b67/voices/Fahco4VZzobUeiPqni1S/BYI5QD0F6odzbXe3n2Nl.mp3"
    },
    {
      "id": "1000000000000000020",
      "name": "Hannah",
      "accentId": "1000000000000000103",
      "description": "Natural and neutral female Australian accent with a warm tone and inspiring edge. Perfect for medical explainers, internal corporate presentations and digital commercials.",
      "isFallback": true,
      "gender": "FEMALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/Hannah.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/workspace/28ae114d62534f90bff78af861985592/voices/M7ya1YbaeFaPXljg9BpK/8Wc09F9557roFsMSjG9E.mp3"
    },
    {
      "id": "1000000000000000018",
      "name": "James",
      "accentId": "1000000000000000102",
      "description": "A young middle aged British professional male voice. Clear and paced, this is a great voice for any setting.",
      "isFallback": false,
      "gender": "MALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/James.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/workspace/e2c52f9641c54df8b869fd5d3c9ce4f4/voices/Yg7C1g7suzNt5TisIqkZ/sbhNgEKtjocuz3m7eIUG.mp3"
    },
    {
      "id": "1000000000000000023",
      "name": "Jenna",
      "accentId": "1000000000000000104",
      "description": "Jenna - Warm and Articulate - A 30 year old female voice in American English - friendly, relatable, and great for podcasts, storytelling and narration.",
      "isFallback": true,
      "gender": "FEMALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/Jenna.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/workspace/9cb6824fef334179a06a0339f1641f9a/voices/TgnhEILA8UwUqIMi20rp/qWh81aKYbMv6xt2Xy6Cf.mp3"
    },
    {
      "id": "1000000000000000013",
      "name": "Jerry",
      "accentId": "1000000000000000101",
      "description": "A warm, calm, and confident baritone voice that feels both friendly and knowledgeable.",
      "isFallback": true,
      "gender": "MALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/Jerry.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/workspace/1da06ea679a54975ad96a2221fe6530d/voices/XA2bIQ92TabjGbpO2xRr/GjIeW766uT1b96dwt98z.mp3"
    },
    {
      "id": "1000000000000000014",
      "name": "Jessica",
      "accentId": "1000000000000000101",
      "description": "Friendly and Conversational Female voice. Articulate, Confident and Helpful. Works well for Conversations.",
      "isFallback": true,
      "gender": "FEMALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/Jessica.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/user/yA8yDNUx4dZ4gwL9ztbTpUEIyR12/voices/g6xIsTj2HwM6VR4iXFCw/1Oqk9SesQxUMxopfgLb7.mp3"
    },
    {
      "id": "1000000000000000012",
      "name": "Juniper",
      "accentId": "1000000000000000101",
      "description": "A grounded female professional, great for podcasts or ConvoAI.",
      "isFallback": true,
      "gender": "FEMALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/Juniper.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/workspace/1da06ea679a54975ad96a2221fe6530d/voices/aMSt68OGf4xUZAnLpTU8/J1MZWsaESdkAy9Offbd7.mp3"
    },
    {
      "id": "1000000000000000017",
      "name": "Katie",
      "accentId": "1000000000000000102",
      "description": "A clear, caring British female voice designed for call centers and customer communication.",
      "isFallback": true,
      "gender": "FEMALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/Katie.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/user/TBCGBdfm5sahGkhMn2WcXK1i4Ya2/voices/MzqUf1HbJ8UmQ0wUsx2p/t0eGqs22ZknvrpntIlz4.mp3"
    },
    {
      "id": "1000000000000000016",
      "name": "Lucy",
      "accentId": "1000000000000000102",
      "description": "Energetic and youthful British voice, perfect for narrations and storytelling. Engaging, natural, and effortlessly conversational.",
      "isFallback": true,
      "gender": "FEMALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/Lucy.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/user/On0pjHuDnweq0BS7b0qVjhIq37i1/voices/lcMyyd2HUfFzxdCaC4Ta/iutd7IQOhAGGiTAJT0X8.mp3"
    },
    {
      "id": "1000000000000000011",
      "name": "Mark",
      "accentId": "1000000000000000101",
      "description": "A casual, young-adult speaking in a natural manner. Perfect for Conversational AI.",
      "isFallback": true,
      "gender": "MALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/Mark.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/workspace/f94e260200764678babc807b935bfb0b/voices/UgBBYS2sOqTuMpoF3BR0/0Oc7jiXwWN9kRTXfQsmw.mp3"
    },
    {
      "id": "1000000000000000024",
      "name": "Michael",
      "accentId": "1000000000000000104",
      "description": "It carries warmth and authority, making complex ideas easy to understand while keeping listeners engaged.",
      "isFallback": true,
      "gender": "MALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/Michael.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/workspace/35a5d91d75654620be0232dbd96764fc/voices/ljX1ZrXuDIIRVcmiVSyR/fqP9bUd1RI4SKDK5zNUN.mp3"
    },
    {
      "id": "1000000000000000019",
      "name": "Pual",
      "accentId": "1000000000000000103",
      "description": "A smooth, articulate Australian male voice with a warm, inviting quality and a confident, professional edge. Suitable for Conversations.",
      "isFallback": true,
      "gender": "MALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/Pual.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/custom/voices/WLKp2jV6nrS8aMkPPDRO/eaTiwieru6XA3d8ocVFK.mp3"
    },
    {
      "id": "1000000000000000022",
      "name": "Tom",
      "accentId": "1000000000000000103",
      "description": "Natural and conversational, with an Aussie tone that's easygoing yet clear. It's low/mid-range in pitch and delivers messages with warmth, sincerity, and a touch of humour when needed.",
      "isFallback": true,
      "gender": "MALE",
      "avatarUrl": "https://novo-one-tst-self-operated-business.s3.ap-east-1.amazonaws.com/public/novo-ai-voice/system/AI_VOICE_AVATAR/Tom.png",
      "previewUrl": "https://storage.googleapis.com/eleven-public-prod/database/user/noVlXbj17nbMQVNRkHqTIt4DD4y2/voices/DYkrAHD8iwork3YSUBbs/RNF2lthsoCmS2gIzKrsn.mp3"
    }
  ],
  "requestId": "6b4545d9eac35f54444b64d75ea17194",
  "code": "200",
  "message": "SUCCESS"
}