Аудио в CLODEx: синтез речи, клонирование голоса и дубляж

CLODEx описывает в документации синтез речи, каталог голосов, клонирование MiniMax, смену голоса, дубляж и асинхронные аудиозадачи. Начать можно через доступный интерфейс Studio, а для интеграции использовать Audio API.

Голоса, форматы и параметры зависят от модели и операции. Голос одного провайдера не следует автоматически передавать другой модели.

Основные маршруты

Операция	Метод и путь
Синхронный синтез речи	POST /v1/audio/speech
Каталог голосов	GET /v1/audio/voices
Список клонов	GET /v1/audio/clones
Создание клона MiniMax	POST /v1/audio/clones
Удаление конкретного клона	DELETE /v1/audio/clones/{id}
Смена голоса	POST /v1/audio/voice-changer
Создание асинхронной аудиозадачи	POST /v1/audios
Статус задачи	GET /v1/audios/{task_id}
Скачивание результата	GET /v1/audios/{task_id}/content?index=0

Для дубляжа используется отдельный процесс загрузки /v1/audio/dubbing/upload/{init,chunk,complete}. Схему его полей и этапов берите из актуальной документации: один вызов TTS не заменяет дубляж видео.

Первый TTS-запрос

Создайте ключ в кабинете, проверьте модель, средства и тариф. Сначала выберите голос, доступный нужному провайдеру. Пример ниже предполагает, что ключ уже находится в окружении, а YOUR_VOICE_ID заменён на совместимый ID:

curl --fail-with-body 'https://clodex.xyz/v1/audio/speech' \
  -H "Authorization: Bearer $CLODEX_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "model":"speech-2.8-hd",
    "voice":"YOUR_VOICE_ID",
    "input":"Здравствуйте! Это тест синтеза речи.",
    "language_code":"ru"
  }' \
  --output speech.mp3

Проверьте успешный HTTP-статус и тип содержимого до воспроизведения: при ошибке файл не становится MP3 только из-за расширения. Модель и формат ответа сверяйте в /docs; не считайте все аудиометоды синхронными.

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

Используйте собственный голос или материал, на обработку которого у вас есть необходимое разрешение. Создание клона — отдельная операция со своим тарифом; последующая озвучка также оплачивается по условиям выбранной модели.

После создания используйте возвращённый ID в совместимом методе синтеза. Для получения своих клонов предусмотрен GET /v1/audio/clones. Удаление адресуется конкретному ID; оно не выполняется простым DELETE /v1/audio/clones без идентификатора.

Не используйте клон для выдачи себя за другого человека или обманной авторизации. Контролируйте доступ к исходным записям и полученным результатам.

Асинхронное аудио и дубляж

Сохраните ID задачи, проверяйте статус и скачивайте результат после успешного завершения. Сетевой тайм-аут не означает, что задачу нужно немедленно создавать заново. Не рассчитывайте на повторяемость загрузки или идемпотентность без подтверждённого контракта метода.

Оплата и проверка

Для Studio требуется платный баланс; промосредства и лимит подписки не заменяют его. Перед запуском проверьте кошелёк, а цену конкретной операции — в каталоге, документации и доступной оценке интерфейса.

Тарификация аудио может зависеть от символов, длительности или типа операции. Не сравнивайте её напрямую со стоимостью миллиона текстовых токенов. После теста проверьте результат и сведения о списании в кабинете.

Документация Audio API · Открыть Studio · Видео API.