Wprowadzenie
Video Sound Effects dodaje do klipu ścieżkę dźwiękową, oglądając go. Wyślij materiał w video_url, opcjonalnie opisz w prompt, co ma być słychać, i wybierz w duration_seconds, ile sekund dźwięku wygenerować. Narzędzie tworzy efekty i tło, które podążają za akcją na ekranie, i zwraca ten sam obraz z tą ścieżką jako dźwiękiem.
Najważniejsze funkcje
Dźwięk, który podąża za obrazem
Ścieżka powstaje z klatek, więc uderzenia, kroki, nalewanie i przejeżdżające auta brzmią tam, gdzie dzieją się w ujęciu, a nie jako pętla położona na wierzch. Krótki opis nadaje kierunek palecie, od deszczu o szybę przez żwir pod stopami po ruchliwą kuchnię, a negatywny prompt wyklucza to, czego nie chcesz, na przykład muzykę albo głosy.
Długość do wyboru, przewidywalna cena
Zamówiona długość to od jednej do trzydziestu sekund i wyznacza zarówno długość gotowego klipu, jak i jego koszt: płacisz za zamówione sekundy, a nie za czas przetwarzania. Sam obraz się nie zmienia, więc kadr i rozdzielczość zostają dokładnie takie, jak w wysłanym klipie.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
video_url | Tak | Klip, któremu dajesz dźwięk. Obraz zostaje bez zmian. od 1 znaków |
prompt | Nie | Dźwięki, których chcesz, w krótkiej liście: deszcz o szybę, daleki ruch uliczny, kroki na żwirze. od 1 znaków · do 1000 znaków |
duration_seconds | Nie | Ile sekund dźwięku wygenerować, od 1 do 30. |
negative_prompt | Nie | Dźwięki do wykluczenia, na przykład muzyka, mowa albo szum wiatru. do 1000 znaków |
ignore_visual_semantics | Nie | Domyślnie wyłączone: model dobiera dźwięki na podstawie obrazu i twojego promptu. Domyślnie: |
guidance_scale | Nie | Jak wiernie dźwięk trzyma się opisu, od 0 do 20. Wartość domyślna pasuje do większości klipów; podnieś ją nieco, jeśli wynik ignoruje prompt. |
steps | Nie | Przebiegi dopracowania, od 4 do 50. Więcej przebiegów trwa dłużej; wartość domyślna to dobry kompromis. |
Cennik
$0.0012 / sekundę wyniku
Opłata za każdą sekundę dźwięku zamówioną w duration_seconds, a nie za długość twojego klipu.
Zastosowania
Wykończenie klipów z modeli wideo
Większość wygenerowanych wideo przychodzi bez dźwięku. Dodanie tła i efektów przed publikacją daje gotowy klip bez szukania w bibliotece dźwięków i bez sesji w programie do montażu, a krótkie klipy zwykle wracają w mniej niż minutę.
Tymczasowy dźwięk do montażu i ujęć produktów
Szkic odtwarzany w ciszy trudno ocenić. Podłóż pod wstępny montaż, klipy z jedzeniem i zapętlone ujęcia produktów wiarygodne tło dźwiękowe, a później je wymień, jeśli scena potrzebuje muzyki.
Wskazówki
Opisuj źródła, nie nastroje
Wymień to, co wydaje dźwięk: syk ekspresu, dzwonienie filiżanek i cichy gwar kawiarni działają lepiej niż przytulny nastrój. Trzy lub cztery źródła wystarczą; długie listy zlewają się w papkę.
Dopasuj długość do klipu
Ustaw duration_seconds na długość klipu, zaokrągloną w górę. Zamówisz więcej, zapłacisz za sekundy, które nigdy się nie pojawią, bo gotowe wideo kończy się tam, gdzie klip; zamówisz mniej, wideo zostanie przycięte do zamówionej długości.
Na początku zostaw precyzyjne ustawienia
guidance_scale określa, jak wiernie dźwięk trzyma się twoich słów, a steps liczbę przebiegów dopracowania; wartości domyślne pasują do większości klipów. Podnoś guidance nieznacznie i tylko wtedy, gdy wynik ignoruje prompt, a po większej liczbie kroków spodziewaj się raczej dłuższego czasu niż wyraźnie lepszego brzmienia.
Szybki start z 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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
