Звук к видеоО модели Video Sound Effects
Озвучьте немой ролик: инструмент смотрит на картинку и создаёт эффекты и атмосферу под действие в кадре, по желанию с описанием, длиной до 30 секунд.
Вызывайте его по имени модели popnow/foley-v1/video-to-audio через POST /jobs/createTask, от 1 кредит за клип длиной 5 с (0,01 $). Новые аккаунты получают 30 бесплатных кредитов, чтобы вы могли сначала попробовать в Playground.
Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
duration_seconds | Нет | Длина ролика. Оплата посекундная. ≥ 1 · ≤ 30 · По умолчанию: 8 |
guidance_scale | Нет | Насколько строго модель следует промпту. ≥ 0 · ≤ 20 · По умолчанию: 4.5 |
ignore_visual_semantics | Нет | Choose the sounds from the prompt alone instead of from what the picture shows; timing still follows the motion. По умолчанию: false |
negative_prompt | Нет | Стили или звуки, которых не должно быть в треке. |
prompt | Нет | The sounds you want, as a short list. If omitted, a general request for sounds that match the on-screen action is used. |
steps | Нет | Больше шагов — больше деталей, но дольше. ≥ 4 · ≤ 50 · По умолчанию: 25 |
video_url | Да | Ролик, с которым работаем. |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за секунду | ≈ USD |
|---|---|---|
| Стандарт | 0,18 | 0,0018 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 1 кредит за клип длиной 5 с (0,01 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Video Sound Effects в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/foley-v1/video-to-audio и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/foley-v1/video-to-audio",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"duration_seconds": 8
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Video Sound Effects
Сколько стоит API Video Sound Effects?
Video Sound Effects стоит 1 кредит (0,01 $) за клип длиной 5 с. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Video Sound Effects в API?
Укажите popnow/foley-v1/video-to-audio — Звук к видео в поле model запроса POST /jobs/createTask.
Обязательно ли описывать звук?
Нет. Без описания отправляется общий запрос на звуки, подходящие к действию в кадре. Несколько конкретных слов обычно дают результат лучше.
Что будет со звуком, который уже есть в ролике?
В готовом видео звуком станет созданная дорожка, поэтому начинайте с немого ролика или с того, чей звук хотите заменить.
Какие ограничения у API Video Sound Effects?
Длина клипа: 1–30 s; Длина промпта (символов): 1,000; Максимальный размер загрузки: 90 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Video Sound Effects без кода?
Да. Playground запускает Video Sound Effects на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.