Referência APIGerenciamento de voz
Listar vozes
Lista vozes públicas e pessoais disponíveis para a chave API atual.
Listar vozes
GET /api/open/v1/voicesURL completo:
https://kittaai.com/api/open/v1/voicesCabeçalhos
Authorization: Bearer FISHAUDIO_API_KEYA listagem de vozes é somente leitura. Não cria tarefas nem consome créditos.
Opções de consulta
O endpoint lê filtros opcionais dos parâmetros de consulta de URL. Se você omiti-los, API retornará a primeira página de vozes públicas.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | inteiro | Não | Número da página. Padrão: 1 |
pageSize | inteiro | Não | Itens por página. Padrão: 20, máximo: 100 |
modelType | corda | Não | public, personal ou all |
includePersonal | booleano | Não | Quando true, o tipo de modelo padrão se torna all |
Resposta
{
"total": 1,
"page": 1,
"pageSize": 20,
"totalPages": 1,
"items": [
{
"voiceId": "voice_123",
"title": "Clara",
"description": "",
"created_at": "2026-07-09T00:00:00.000Z",
"updated_at": "2026-07-09T00:00:00.000Z",
"isPersonal": false
}
]
}Use items[].voiceId em solicitações TTS.
Teste rápido de voz
Para testar TTS antes de escolher uma voz na resposta, use este ID de voz do sistema público:
00a1b221-6137-4b73-ad62-b0cbce134167Substitua-o por um valor items[].voiceId quando estiver pronto para selecionar uma voz de produção.
Exemplo curl
curl "https://kittaai.com/api/open/v1/voices?page=1&pageSize=20&modelType=public" \
-H "Authorization: Bearer FISHAUDIO_API_KEY"Erros
| Estado | Significado |
|---|---|
401 | A chave API está ausente ou é inválida |
403 | A conta não pode listar vozes |
500 | Falha na consulta do catálogo de voz |