Список голосов

Список публичных и личных голосов, доступных для текущего ключа API.

GET /api/open/v1/voices

Полный URL-адрес:

https://fishaudio.org/api/open/v1/voices

Заголовки

Authorization: Bearer FISHAUDIO_API_KEY

Список голосов доступен только для чтения. Он не создает заданий и не потребляет кредиты.

Параметры запроса

Конечная точка считывает дополнительные фильтры из параметров запроса URL-адреса. Если вы их опустите, API вернет первую страницу публичных голосов.

Поле	Тип	Требуется	Описание
`page`	целое число	Нет	Номер страницы. По умолчанию: `1`
`pageSize`	целое число	Нет	Элементов на странице. По умолчанию: `20`, максимум: `100`
`modelType`	строка	Нет	`public`, `personal` или `all`
`includePersonal`	логическое	Нет	Если `true`, тип модели по умолчанию становится `all`
`language`	строка	Нет	Точное совпадение основного языка, например `zh` или `en`
`supportsLanguage`	строка	Нет	Фильтр голосов, поддерживающих указанный код языка
`search`	строка	Нет	Поиск по имени или описанию без учета регистра

Ответ

{
  "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://fishaudio.org/api/open/v1/voices?page=1&pageSize=20&modelType=public" \
  -H "Authorization: Bearer FISHAUDIO_API_KEY"

Ошибки

Статус	Значение
`401`	Ключ API отсутствует или недействителен
`403`	В аккаунте не могут быть перечислены голоса
`500`	Не удалось выполнить запрос к голосовому каталогу

Предпросмотр запроса

GET https://fishaudio.org/api/open/v1/voices?modelType=all&includePersonal=true&page=1&pageSize=20
Authorization: Bearer YOUR_API_KEY