Skip to main content
GET
List voices

Autorizaciones

Authorization
string
header
requerido

A Bearer token. Create keys in the portal under Settings > API keys (https://app.ryvo.so/developers). The token has the form ryvo_live_<64 hex characters> and is shown once.

Header: Authorization: Bearer ryvo_live_...

Parámetros de consulta

limit
integer
predeterminado:20

Page size, 1 to 100. Default 20.

Rango requerido: 1 <= x <= 100
cursor
string

The next_cursor of the previous page. Opaque.

Ejemplo:

"eyJvIjoyMH0"

provider
enum<string>

Only voices from this provider.

Opciones disponibles:
elevenlabs,
cartesia,
deepgram
language
string

A two-letter language code the voice speaks, for example es or en.

Pattern: ^[a-zA-Z]{2,3}$
Ejemplo:

"es"

gender
enum<string>
Opciones disponibles:
female,
male,
neutral
q
string

Case-insensitive search in the voice name.

Maximum string length: 100

true for the hand-picked voices only, false to exclude them.

Opciones disponibles:
true,
false

Respuesta

A page of voices.

The envelope of every list. data is typed per endpoint.

data
object[]
requerido
has_more
boolean
requerido

Whether another page exists.

Ejemplo:

true

next_cursor
string | null
requerido

Pass as ?cursor= to fetch the next page. null on the last page.

Ejemplo:

"eyJvIjoyMH0"