Dźwięk do wideoO modelu Video Sound Effects
Daj niememu klipowi dźwięk: narzędzie ogląda obraz i generuje efekty oraz tło pasujące do akcji, sterowane opcjonalnym opisem, do 30 sekund.
Wywołujesz go nazwą modelu popnow/foley-v1/video-to-audio w POST /jobs/createTask, od 1 kredyt za klip 5-sekundowy (0,01 USD). Nowe konta dostają 30 darmowych kredytów, więc możesz najpierw przetestować go w Playgroundzie.
Ten poradnik jest na razie tylko po angielsku. →
Parametry żądania
| Parametr | Wymagany | Opis |
|---|---|---|
duration_seconds | Nie | Długość klipu. Płacisz za każdą sekundę. ≥ 1 · ≤ 30 · Domyślnie: 8 |
guidance_scale | Nie | Jak ściśle model trzyma się promptu. ≥ 0 · ≤ 20 · Domyślnie: 4.5 |
ignore_visual_semantics | Nie | Choose the sounds from the prompt alone instead of from what the picture shows; timing still follows the motion. Domyślnie: false |
negative_prompt | Nie | Style lub dźwięki, których nie chcesz w utworze. |
prompt | Nie | The sounds you want, as a short list. If omitted, a general request for sounds that match the on-screen action is used. |
steps | Nie | Więcej kroków to więcej detali, ale dłużej. ≥ 4 · ≤ 50 · Domyślnie: 25 |
video_url | Tak | Klip do obróbki. |
Ceny
Ceny podajemy w kredytach, tych samych, których używasz na stronie (1 kredyt = 0,01 $). Kwota jest rezerwowana, gdy zadanie zostaje przyjęte, a po zakończeniu rozliczana według rzeczywistego kosztu; za nieudane zadania kredyty wracają.
| Opcja | Kredyty za sekundę | ≈ USD |
|---|---|---|
| Standard | 0,18 | 0,0018 USD |
Każde zadanie jest zaokrąglane w górę do pełnych kredytów, więc jedno uruchomienie na najniższym poziomie kosztuje 1 kredyt za klip 5-sekundowy (0,01 USD).
Żeby poznać dokładną kwotę przed uruchomieniem, wyślij to samo body na POST /jobs/quote.
Szybki start z API
Wywołaj API Video Sound Effects w trzech krokach
- Utwórz klucz API. Zaloguj się do PopNow i utwórz klucz w konsoli API. Klucze zaczynają się od sk-popnow- i korzystają z tych samych kredytów co strona.
- Wyślij żądanie. Wyślij POST /jobs/createTask z model popnow/foley-v1/video-to-audio i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
- Odbierz wynik. Odpytuj GET /jobs/recordInfo po ID zadania albo podaj callBackUrl, a wyślemy tam wynik. Gdy zadanie się powiedzie, pobierz pliki z linków wyjściowych.
# 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"Podmień prompt i linki na własne. Odniesienie do odpowiedzi, odpytywania i callbacku znajdziesz na karcie API.
Pytania o API Video Sound Effects
Ile kosztuje API Video Sound Effects?
Video Sound Effects kosztuje 1 kredyt (0,01 USD) za klip 5-sekundowy. Kredyty są te same co na stronie (1 kredyt = 0,01 USD), nowe konta dostają 30 darmowych kredytów, a nieudane zadania są zwracane.
Jaka jest nazwa modelu Video Sound Effects w API?
Wpisz popnow/foley-v1/video-to-audio do zadania Dźwięk do wideo w polu model żądania POST /jobs/createTask.
Czy muszę opisywać dźwięk?
Nie. Bez opisu wysyłana jest ogólna prośba o dźwięki pasujące do akcji na ekranie. Kilka konkretnych słów zwykle daje lepszy wynik.
Co dzieje się z dźwiękiem, który już jest w klipie?
Gotowe wideo niesie wygenerowaną ścieżkę jako dźwięk, więc zacznij od niemego klipu albo takiego, którego dźwięk chcesz zastąpić.
Jakie limity ma API Video Sound Effects?
Długość klipu: 1–30 s; Długość promptu (znaki): 1,000; Największy przesyłany plik: 90 MB. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.
Czy mogę wypróbować Video Sound Effects bez pisania kodu?
Tak. Playground uruchamia Video Sound Effects na twoich kredytach PopNow, nie wymaga klucza API i pokazuje kod do każdej generacji.