Skip to main content
GET
/
v1
/
voices
Get public voices
curl --request GET \
  --url https://api.voicedub.ai/v1/voices \
  --header 'Authorization: <api-key>'
{
  "voices": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Plankton",
      "languages": [
        "english",
        "spanish"
      ],
      "genres": [
        "pop",
        "country"
      ],
      "styles": [
        "singing",
        "speaking"
      ],
      "avatarFormat": "webp",
      "createdAt": "2024-01-15T10:00:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z",
      "avatarUrl": "https://example.com/voices/123e4567-e89b-12d3-a456-426614174000.webp"
    }
  ],
  "nextCursor": "2_123e4567-e89b-12d3-a456-426614174001"
}

Authorizations

​
Authorization
string
header
required

API key in the format: "Api-Key "

Query Parameters

​
search
string

Search term to filter voices by name

Required string length: 1 - 50
Example:

"plankton"

​
genres
enum<string>[]

Filter by musical genres. Multiple values are OR'd within this filter and combined with other filters using AND.

Available options:
pop,
rap,
rock,
country,
rnb,
alternative,
jazz
Example:
["pop", "country"]
​
languages
enum<string>[]

Filter by supported languages. Multiple values are OR'd within this filter and combined with other filters using AND.

Available options:
english,
spanish,
korean,
japanese,
french,
russian,
thai
Example:
["english"]
​
styles
enum<string>[]

Filter by voice styles. Multiple values are OR'd within this filter and combined with other filters using AND.

Available options:
singing,
rapping,
speaking,
character,
other
Example:
["singing"]
​
limit
integer
default:50

Number of voices to return (8-50)

Required range: 8 <= x <= 50
Example:

20

​
cursor
string

Pagination cursor for next page

Example:

"1_123e4567-e89b-12d3-a456-426614174000"

Response

200 - application/json

Voices retrieved successfully

​
voices
object[]
required
​
nextCursor
string | null
required

Cursor for next page, null if no more pages

Example:

"2_123e4567-e89b-12d3-a456-426614174001"