Введение
Video Sound Effects добавляет звуковую дорожку к ролику, просматривая его. Отправьте материал в video_url, при желании опишите в prompt, что должно звучать, и выберите в duration_seconds, сколько секунд звука создать. Инструмент создаёт эффекты и атмосферу, которые следуют за действием в кадре, и возвращает ту же картинку с этой дорожкой в качестве звука.
Ключевые возможности и особенности
Звук, который следует за картинкой
Дорожка создаётся по кадрам, поэтому удары, шаги, льющаяся вода и проезжающие машины звучат там, где они происходят в кадре, а не петлёй поверх. Короткое описание задаёт палитру — от дождя по стеклу до гравия под ногами или шумной кухни, — а негативный промпт убирает то, что не нужно, например музыку или голоса.
Длина на ваш выбор, предсказуемая цена
Запрошенная длина — от одной до тридцати секунд — определяет и длину готового ролика, и его стоимость: вы платите за запрошенные секунды, а не за время обработки. Сама картинка не меняется, поэтому кадр и разрешение остаются точно такими, как в присланном ролике.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Ролик, который нужно озвучить. Картинка остаётся как есть. Не менее 1 символов |
prompt | Нет | Нужные звуки коротким списком: дождь по окну, далёкий транспорт, шаги по гравию. Если оставить пустым, вместо этого отправится общий запрос на звуки, подходящие к действию в кадре. Не менее 1 символов · Не более 1000 символов |
duration_seconds | Нет | Сколько секунд звука создать, от 1 до 30. Готовое видео обрезается до этой длины, и эти секунды оплачиваются, даже если ролик короче, поэтому подгоняйте значение под ролик. |
negative_prompt | Нет | Звуки, которые нужно исключить, например музыку, речь или шум ветра. Не более 1000 символов |
ignore_visual_semantics | Нет | По умолчанию выключено: модель выбирает звуки по изображению и по вашему промпту. По умолчанию: |
guidance_scale | Нет | Насколько точно звук следует описанию, от 0 до 20. Значение по умолчанию подходит большинству роликов; немного увеличьте его, если результат игнорирует промпт. |
steps | Нет | Проходы доработки, от 4 до 50. Больше проходов — дольше обработка; значение по умолчанию — хороший баланс. |
Стоимость
$0.0012 / секунда результата
Оплата за каждую секунду звука, запрошенную в duration_seconds, а не за длину вашего ролика.
Сценарии использования
Доводка роликов из видеомоделей
Большинство сгенерированных видео приходят без звука. Если добавить атмосферу и эффекты перед публикацией, ролик готов без поисков в библиотеке звуков и без сессии в монтажке, а короткие ролики обычно возвращаются меньше чем за минуту.
Временный звук для черновиков и продуктовых планов
Черновик, который идёт в тишине, трудно оценить. Подложите под черновой монтаж, ролики с едой и зацикленные продуктовые планы правдоподобный звуковой фон и замените его позже, если сцене нужна музыка.
Руководство по промптам и практические советы
Описывайте источники, а не настроение
Перечислите то, что издаёт звук: шипение кофемашины, звон чашек и негромкий гул кафе работают лучше, чем уютная атмосфера. Трёх-четырёх источников достаточно; длинные списки сливаются в кашу.
Подгоняйте длину под ролик
Задайте duration_seconds по длине ролика с округлением вверх. Запросите больше — и заплатите за секунды, которые так и не появятся, потому что готовое видео заканчивается там, где заканчивается ролик; запросите меньше — и видео обрежется до запрошенного.
Сначала не трогайте тонкие настройки
guidance_scale задаёт, насколько звук следует вашим словам, а steps — число проходов доработки; значения по умолчанию подходят большинству роликов. Повышайте guidance немного и только если результат игнорирует промпт, а от большего числа шагов ждите скорее более долгой обработки, чем заметно лучшего звука.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/foley-v1/video-to-audio",
"input": {
"duration_seconds": 8,
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
