Руководство по использованию
ElevenLabs Sound Effects v3 API: 30-секундные звуковые эффекты, бесшовные циклы и миграция с v2
Цены, параметры, примеры запросов и написание промптов — всё в одной статье
- Модель
- elevenlabs-sound-effects
На этой странице
Что умеет Sound Effects v3
ElevenLabs Sound Effects v3 — модель генерации звуков по тексту на HiAPI, её ID — elevenlabs/sound-effects-v3. Опишите нужный звук текстом — действие, сцену, атмосферу и манеру исполнения — и модель сгенерирует соответствующий звуковой эффект. Длительность можно задать от 0,5 до 30 секунд, а также запросить генерацию зацикленного звука с бесшовной стыковкой начала и конца.
Каждый вызов генерирует 1 аудиофайл MP3. В статье описаны цены, параметры, примеры запросов, отличия от v2 и способы написания промптов. Приведённые цифры соответствуют определению интерфейса на момент написания.
Цены Sound Effects v3 API
Оплата зависит от запрошенной длительности (duration_seconds) — $0,0029 за секунду.
- 2 секунды (значение по умолчанию): $0,0058
- 5 секунд: $0,0145
- 10 секунд: $0,029
- 30 секунд (максимум): $0,087
Включение цикла (loop) или изменение prompt_influence не оплачивается дополнительно. При неудаче задания средства возвращаются полностью. Цена v2 также составляет $0,0029/сек — обе версии стоят одинаково.
Параметры
Обязательны только prompt и duration_seconds, остальные параметры можно не передавать.
prompt: обязательный, от 1 до 450 символов, описывает генерируемый звук.duration_seconds: обязательный, от 0,5 до 30 секунд, «автоматической длительности» нет.loop: генерировать ли звук с бесшовным циклом воспроизведения, по умолчаниюfalse.prompt_influence: от 0 до 1, по умолчанию 0,3. Чем выше значение, тем ближе результат к буквальному описанию в промпте; чем ниже — тем больше вариативности.
Отправка запроса
Генерация звуковых эффектов в HiAPI — асинхронная задача: сначала создаётся задача, затем запрашивается результат. model указывается на верхнем уровне, остальные параметры — внутри input.
Генерация 5-секундного звука открывающейся двери:
curl -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "elevenlabs/sound-effects-v3",
"input": {
"prompt": "Heavy wooden door creaking open slowly in a quiet stone hallway, then a soft thud as it stops",
"duration_seconds": 5
}
}'
Генерация 10-секундного зацикленного шума дождя:
{
"model": "elevenlabs/sound-effects-v3",
"input": {
"prompt": "Gentle rain on a tin roof with distant rolling thunder, calm night ambience, no music",
"duration_seconds": 10,
"loop": true
}
}
Стоимость второго запроса — 10 × $0,0029 = $0,029. После создания задачи опрашивайте GET https://api.hiapi.ai/v1/tasks/{taskId}; когда статус станет «успешно», скачайте адрес аудио из вывода.
Чем v3 отличается от v2
Имена параметров и цены у обеих версий одинаковые; в HiAPI есть три основных отличия:
- Максимальная длительность: v3 — до 30 секунд, v2 — до 22 секунд. Для эмбиента или фонового звука длительностью 22–30 секунд подходит только v3.
- Качество: официальная документация ElevenLabs говорит, что по сравнению с v2 модель v3 точнее следует промптам с несколькими инструкциями, лучше обрабатывает промпты с музыкой или вокалом, звучит естественнее и меньше подвержена клиппингу при генерации высокочастотных звуков вроде ветряных колокольчиков и свистков. Официально также отмечено, что результаты зависят от промпта, поэтому рекомендуется сравнить обе версии на своих промптах.
- Дальнейшая поддержка: ElevenLabs официально пометила v2 (
eleven_text_to_sound_v2) как устаревшую и планирует отключить её 1 марта 2027 года. Новым проектам рекомендуется сразу использовать v3.
Для миграции с v2 на v3 достаточно изменить model на elevenlabs/sound-effects-v3, остальные параметры менять не нужно. Перед запуском в продакшен рекомендуется сравнить результаты обеих версий на нескольких часто используемых в бизнесе промптах.
Как писать промпты
- Описывайте конкретное действие, сцену, атмосферу и манеру исполнения, а не только общую категорию. Например, «шаги по мокрому гравию, медленный темп» даёт более стабильный результат, чем «звук шагов».
- Можно описывать последовательность, например «Footsteps on gravel, then a metallic door opens» (сначала шаги по гравию, затем открывается металлическая дверь).
- Можно использовать отраслевые термины звуковых эффектов, например impact (удар), whoosh (свист пролёта), ambience (эмбиент), one-shot (однократный звук), drone (непрерывный фоновый тон).
- Не рассчитывайте, что модель строго повторит заданное число раз. Официально указано, что требования точного количества вроде «ударить в треугольник 4 раза» могут не выполняться. Если нужен точный ритм, сгенерируйте один раз, а затем смонтируйте и склейте самостоятельно.
- Настраивайте
prompt_influenceпо необходимости: для звуков интерфейса и уведомлений, где нужна стабильная согласованность, можно поднять до 0,6 и выше; если нужно несколько вариантов в разных стилях, используйте значение по умолчанию 0,3 или ниже.
Текущие ограничения
- Каждый вызов генерирует только 1 аудиофрагмент. Для нескольких кандидатов запускайте несколько задач параллельно.
- Диапазон длительности — 0,5–30 секунд, её нужно указывать явно, автоматической длительности нет.
- Промпт — не более 450 символов.
- Поддерживаются только асинхронные задачи, синхронного возврата нет.
- Выходной формат — MP3, другие форматы пока выбрать нельзя.
Для каких сценариев подходит
v3 подходит для сценариев, где нужно массово и быстро создавать короткие звуковые эффекты: звуки интерфейса в играх и приложениях, переходные эффекты в коротких видео и рекламе, черновые фоли-сэмплы для кино или трейлеров, а также зацикленный эмбиент для аудиокниг и стримов. Пятисекундный звук стоит $0,0145 — можно сначала пакетно сгенерировать несколько версий, выбрать подходящую и отправить в постпродакшен; это дешевле, чем раз за разом искать и править материалы.
Похожие статьи
Все статьи →-
Руководство по использованию
Руководство по началу работы с Tripo H3.1: три способа ввода, параметры и как выбрать тариф
Практическое руководство для разработчиков по принятию решений и контролю затрат при интеграции генерации 3D
-
Руководство по использованию
Генерация изображений товаров для электронной коммерции с помощью qwen-image-2.1-turbo через HiAPI API
Быстрый рабочий процесс визуализации каталога для разработчиков: прозрачный вывод PNG и работающий API-запрос
-
Руководство по использованию
Использование topaz-upscale/video через HiAPI API: рабочий процесс улучшения качества коротких видео
Интерполяция кадров, настройки усиления и рабочий запрос к HiAPI для вертикальных видео