Fish Audio Docs
API СсылкаГолосовое управление
Back to site

Клонирование голоса

Загрузите эталонный звук и создайте собственный голос.

Клонирование голоса

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 текущей учетной записи и распределения поставщика.