API СсылкаГолосовое управление
Список голосов
Список публичных и личных голосов, доступных для текущего ключа API.
Список голосов
GET /api/open/v1/voicesПолный URL-адрес:
https://kittaai.com/api/open/v1/voicesЗаголовки
Authorization: Bearer FISHAUDIO_API_KEYСписок голосов доступен только для чтения. Он не создает заданий и не потребляет кредиты.
Параметры запроса
Конечная точка считывает дополнительные фильтры из параметров запроса URL-адреса. Если вы их опустите, API вернет первую страницу публичных голосов.
| Поле | Тип | Требуется | Описание |
|---|---|---|---|
page | целое число | Нет | Номер страницы. По умолчанию: 1 |
pageSize | целое число | Нет | Элементов на странице. По умолчанию: 20, максимум: 100 |
modelType | строка | Нет | public, personal или all |
includePersonal | логическое | Нет | Если true, тип модели по умолчанию становится all |
Ответ
{
"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
}
]
}Используйте items[].voiceId в запросах TTS.
Быстрый голосовой тест
Чтобы протестировать TTS перед выбором голоса из ответа, используйте этот общедоступный системный голосовой идентификатор:
00a1b221-6137-4b73-ad62-b0cbce134167Замените его значением items[].voiceId, когда будете готовы выбрать производственный голос.
curl Пример
curl "https://kittaai.com/api/open/v1/voices?page=1&pageSize=20&modelType=public" \
-H "Authorization: Bearer FISHAUDIO_API_KEY"Ошибки
| Статус | Значение |
|---|---|
401 | Ключ API отсутствует или недействителен |
403 | В аккаунте не могут быть перечислены голоса |
500 | Не удалось выполнить запрос к голосовому каталогу |