API СсылкаГолосовое управление
Клонирование голоса
Загрузите эталонный звук и создайте собственный голос.
Клонирование голоса
POST /api/open/v1/voices
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: multipart/form-dataПолный URL-адрес:
https://fishaudio.org/api/open/v1/voicesДля создания голоса используется эталонный звук и процесс создания FishAudio. Маршрут Open API игнорирует переопределения поставщика, поэтому вам не нужно отправлять поле provider.
Поля запроса
| Поле | Тип | Требуется | Описание |
|---|---|---|---|
name | строка | Да | Голосовое имя |
audioFiles | файл[] | Да | Один или несколько эталонных аудиофайлов |
description | строка | Нет | Описание голоса |
referenceText | строка | Нет | Расшифровка справочного аудио |
visibility | строка | Нет | private или public. По умолчанию: private |
languages | строка | Нет | Массив строк JSON, например '["zh","en"]' |
Поддерживаемые расширения файлов: aac, flac, m4a, mp3, mp4, mpeg, oga, ogg, opus, wav и webm. Каждый файл может иметь размер до 10MB.
Не устанавливайте составную границу вручную. При использовании curl -F, браузера FormData или SDK позвольте клиенту генерировать Content-Type.
curl Пример
curl -X POST "https://fishaudio.org/api/open/v1/voices" \
-H "Authorization: Bearer FISHAUDIO_API_KEY" \
-F "name=My cloned voice" \
-F "description=Chinese narration voice" \
-F "visibility=private" \
-F 'languages=["zh"]' \
-F "audioFiles=@/path/to/sample-1.mp3;type=audio/mpeg" \
-F "audioFiles=@/path/to/sample-2.wav;type=audio/wav"Ответ
{
"voiceId": "voice_abc123",
"title": "My cloned voice",
"description": "Chinese narration voice",
"createdAt": "2026-07-09T00:00:00.000Z"
}Сохраните возвращенный voiceId, а затем передайте его непосредственно при генерации речи.
Ошибки
| Статус | Значение |
|---|---|
400 | Отсутствуют поля, неподдерживаемый тип файла или файл слишком большого размера |
401 | Ключ API отсутствует или недействителен |
403 | Аккаунт не может создавать голоса |
429 | Запросы на создание голоса поступают слишком часто |
500 | На сервере не удалось создать голос |
Создание голосовых записей Использование Open API зависит от квоты Open API текущей учетной записи и распределения поставщика.