Listar vozes
Obtém uma lista de todas as vozes disponíveis para um usuário, com pesquisa, filtros e paginação.
Cabeçalhos
Parâmetros de consulta
O próximo token de página a ser usado na paginação. Retornado pela solicitação anterior. Use-o em conjunto com a flag has_more para uma paginação confiável.
Quantidade máxima de vozes a retornar. Não pode exceder 100; o padrão é 10. A página 0 pode incluir mais vozes devido à inclusão de vozes padrão.
Termo de pesquisa para filtrar vozes. Pesquisa em nome, descrição, rótulos e categoria.
Por qual campo ordenar: ‘created_at_unix’ ou ‘name’. ‘created_at_unix’ pode não estar disponível para vozes mais antigas.
Em qual direção ordenar as vozes: ‘asc’ ou ‘desc’.
Categoria da voz para filtrar. Uma de: ‘premade’, ‘cloned’, ‘generated’, ‘professional’
Estado do Finetune da voz para filtrar. Aplicável apenas a clones de voz profissionais. Um entre: ‘draft’, ‘not_verified’, ‘not_started’, ‘queued’, ‘fine_tuning’, ‘fine_tuned’, ‘failed’, ‘delayed’.
ID da coleção para filtrar vozes.
Gênero usado para filtragem, com base no rótulo ‘gender’ da voz.
Idade usada para filtragem, com base no rótulo ‘age’ da voz.
Idiomas usados para filtragem, com base no rótulo ‘language’ da voz. São retornadas vozes que correspondem a qualquer um dos idiomas informados.
Sotaque usado para filtragem, com base no rótulo ‘accent’ da voz.
Casos de uso para filtragem, com base no rótulo ‘use_case’ da voz. São retornadas as vozes que correspondem a qualquer um dos casos de uso fornecidos.
Filtre vozes cujo período de aviso de compartilhamento seja de pelo menos o número de dias informado.
Indica se deve incluir vozes que têm uma taxa de compartilhamento personalizada. Por padrão, elas são incluídas.
Indica se deve incluir vozes com moderação ao vivo ativada. Por padrão, elas são incluídas.
Quando true, retorna apenas vozes com qualidade de estúdio (aquelas cuja categoria é ‘high_quality’).
IDs de voz a serem pesquisados. Máximo de 100 IDs de voz.
Resposta
Resposta bem-sucedida
A lista de vozes que correspondem à consulta.
Indica se há mais vozes disponíveis nas páginas seguintes. Use este sinalizador, junto com next_page_token, para uma paginação confiável, em vez de depender de total_count.
A contagem total de vozes que correspondem à consulta. Esse valor é um retrato em tempo real que reflete o estado atual do banco de dados e pode mudar entre solicitações à medida que usuários criam, modificam ou excluem vozes. Para uma paginação confiável, use a flag has_more em vez de depender desse valor. Solicite esse campo apenas quando realmente precisar da contagem total, por exemplo, para exibição, pois calculá-lo tem um custo de desempenho.
Token para recuperar a próxima página de resultados. Passe esse valor na próxima solicitação para continuar a paginação. Nulo se não houver mais resultados.