Wprowadzenie
Wyodrębnij pierwszy plan istniejącego klipu i wybierz przezroczystość lub jednolite tło. Domyślne żądanie dotyczy przezroczystego WebM VP9 z oryginalnym dźwiękiem.
| Pole | Wartość |
|---|---|
| Wejście | Wideo |
| Wyjście | Wideo |
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
video_url | Tak | Klip źródłowy o długości od 1 do 60 sekund. Wynik wyodrębnia wykryty pierwszy plan; nie ma możliwości sterowania kadrowaniem. od 1 znaków |
background | Nie | Wybierz przezroczystość lub jeden z dziesięciu jednolitych kolorów. Przezroczysty wynik wymaga formatu obsługującego kanał alfa. |
output_format | Nie | Ustawienie wstępne kontenera i kodeka. Domyślny jest WebM VP9. |
keep_original_audio | Nie | Żąda oryginalnego dźwięku w wyniku; opcja domyślnie włączona. Wyłącz ją, aby uzyskać klip bez dźwięku. Domyślnie: |
Cennik
$0.06 / sekunda
Opłata za każdą sekundę wejściowego wideo, z zaokrągleniem w górę do pełnej sekundy. Ten endpoint przyjmuje klipy o długości od 1 do 60 sekund. Wybór tła, formatu i dźwięku nie zmienia tej reguły opartej na czasie trwania.
Zastosowania
Wideo → Edycja wideo → Wideo
Edycja wideo
Wideo
Zadanie asynchroniczne
Wskazówki
Wprowadzenie
Narzędzie do usuwania tła wideo wyodrębnia pierwszy plan istniejącego wideo na potrzeby kompozycji lub umieszczenia na jednolitym tle. Wyślij video_url i wybierz tło oraz format eksportu. Domyślne żądanie dotyczy przezroczystego WebM VP9 i zachowania oryginalnego dźwięku. Ten endpoint przyjmuje klipy źródłowe o długości od 1 do 60 sekund; nie generuje nowej sceny na podstawie promptu.
Najważniejsze funkcje i zalety
Przezroczystość zależy od wyboru tła i formatu
Ustaw background na transparent i użyj formatu obsługującego kanał alfa. WebM VP9, MOV ProRes 4444, MKV VP9 i GIF to opcje z udokumentowaną obsługą kanału alfa. Tutejsze ustawienia wstępne MP4 oraz MKV H.264 lub H.265 nie zawierają kanału alfa; niezgodne żądania przezroczystości mogą zostać odrzucone. MOV H.265 ma jedynie częściową udokumentowaną obsługę, dlatego w domyślnym procesie pracy z przezroczystością używaj WebM VP9 i sprawdzaj rzeczywisty wynik przed utworzeniem kompozycji.
Jednolite kolory i oryginalny dźwięk
Możesz też wybrać kolor czarny, biały, szary, czerwony, zielony, niebieski, żółty, cyjan, magenta lub pomarańczowy. keep_original_audio określa, czy w wyniku ma zostać zażądany dźwięk źródłowy. GIF nie może zawierać ścieżki dźwiękowej; wyłącz zachowywanie dźwięku, gdy go wybierasz. Wybór kontenera, kodeka i tła nie zmienia reguły naliczania opłat na podstawie czasu trwania. Rozliczenie wykorzystuje sekundy wejściowe zaokrąglone w górę, a ten endpoint nie udostępnia sterowania kadrowaniem ani rozdzielczością wyjściową.
Zastosowania
Umieszczenie prelegenta na tle prezentacji
Zacznij od krótkiego klipu, w którym prelegent wyraźnie odróżnia się od tła. Zażądaj przezroczystego WebM VP9, a następnie umieść wynik nad slajdem lub sceną w edytorze obsługującym ten format. Przed opublikowaniem kompozycji sprawdź włosy i krawędzie rozmyte przez ruch zarówno na ciemnym, jak i jasnym tle.
Przygotowanie klipu produktu do nowego układu
Oddziel produkt od pierwotnego otoczenia, aby ponownie wykorzystać nagranie w układzie katalogu lub montażu do mediów społecznościowych. Eksport z jednolitym kolorem może się przydać, gdy przezroczystość nie jest potrzebna. Powierzchnie odbijające światło i drobne krawędzie wymagają uważnej oceny: wynik jest przetworzoną maską i należy go oceniać na docelowym tle, a nie tylko na podglądzie z szachownicą.
Przewodnik po promptach i praktyczne wskazówki
Świadomy wybór formatu końcowego
W domyślnym procesie pracy z wideo zachowaj background=transparent, output_format=webm_vp9 i keep_original_audio=true. Inne ustawienie wstępne wybierz dopiero po sprawdzeniu, czy edytor może je zaimportować. Obsługa odtwarzania w internecie zależy od przeglądarki i kodeka; udane pobranie nie dowodzi, że osadzony podgląd lub późniejsza edycja będą działać. Zachowaj przezroczysty plik wzorcowy, gdy tworzysz osobny podgląd spłaszczony z tłem do udostępniania.
Weryfikacja przezroczystości i całego klipu
Sprawdź rzeczywisty kanał alfa i nałóż wynik na czarne, białe oraz nasycone kolorowe tło. Plik pokazujący szachownicę lub czarny prostokąt nie jest dowodem na działającą przezroczystość. Przejrzyj cały ruch pod kątem zmian krawędzi i porównaj czas trwania, wymiary klatek oraz synchronizację dźwięku z oryginałem. Nie wnioskuj o obecności kanału alfa na podstawie nazwy pliku lub wybranych opcji. Dla tej integracji nie ukończono jeszcze testu jakości materiałów ani zgodności z przeglądarkami; zweryfikuj wynik w docelowym procesie pracy.
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/background-remover-video-v1/video-edit",
"input": {
"background": "transparent",
"output_format": "webm_vp9",
"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.
