Wprowadzenie
Usuń stały obszar w całym filmie za pomocą maski obrazu z białym obszarem na czarnym tle. Opcjonalna instrukcja opisuje miejscowe usunięcie; ta sama maska jest stosowana do całego klipu.
| Pole | Wartość |
|---|---|
| Wejście | Wideo |
| Wyjście | Wideo |
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
video_url | Tak | Cały film do przetworzenia, o długości od 1 do 600 sekund. Zaznaczony obszar jest przetwarzany przez cały klip. od 1 znaków |
mask_url | Tak | Jeden statyczny obraz PNG wyrównany do klatki filmu. Zamaluj obszar do usunięcia na biało, a pozostały obszar na czarno. od 1 znaków |
prompt | Nie | Opcjonalne wskazówki dotyczące miejscowego usunięcia. Nie wybierają przedziału czasu ani nie włączają śledzenia. |
Cennik
$0.024 / sekunda
Opłata jest naliczana za cały klip wejściowy, z zaokrągleniem w górę do pełnych sekund i minimalnym rozliczanym czasem 3 sekund. Ten endpoint przyjmuje klipy od 1 do 600 sekund; rozmiar maski nie skraca czasu.
Zastosowania
Wideo → Edycja wideo → Wideo
Edycja wideo
Wideo
Zadanie asynchroniczne
Wskazówki
Wprowadzenie
Video Eraser usuwa treść wewnątrz statycznej maski obrazu w całym klipie wideo. Prześlij video_url i mask_url, opcjonalnie dodając krótki prompt opisujący usunięcie. Narzędzie nadaje się do stałego pasa napisów lub innego niechcianego elementu, który pozostaje w tym samym obszarze ekranu. Wynikowe tło jest wypełnieniem opartym na wnioskowaniu, a nie odzyskaniem ukrytych oryginalnych pikseli.
Główne funkcje i wyróżniki
Stały obszar dla całego klipu
Maska jest nieruchomym obrazem: biel oznacza obszar do usunięcia, a czerń obszar do zachowania. Ten sam obszar ekranu jest stosowany przez cały przesłany film. Nie ma pola czasu rozpoczęcia, pola czasu zakończenia ani elementu sterującego śledzeniem poruszających się obiektów. Napis, który przesunie się poza biały obszar, nie zostanie objęty tą maską. Wypełnienie może też zmienić treść przechodzącą przez zaznaczony obszar.
Opcjonalny opis dołączony do maski
Krótki opis może wyjaśnić, co należy usunąć i co znajduje się wokół. Maska pozostaje wymagana dla tego endpointu, aby obszar był jednoznacznie określony. Opłata za przetwarzanie jest naliczana za cały klip wejściowy, z zaokrągleniem w górę do pełnych sekund i minimalnym rozliczanym czasem 3 sekund. Akceptowane klipy źródłowe mają długość od 1 do 600 sekund. Mniejsza maska nie skraca rozliczanej długości filmu.
Przypadki użycia
Usunięcie stałego pasa napisów
W przypadku napisów już wtopionych w Twój własny materiał zaznacz pas napisów i sprawdź każdy fragment, w którym pojawia się tekst. Statyczne tło jest dobrym punktem wyjścia do oceny wyniku. Jeśli napisy nadal są w projekcie edytowalnymi warstwami tekstowymi, usuń te warstwy bezpośrednio, zanim wybierzesz rekonstrukcję pikseli.
Usunięcie nieruchomej nakładki
Użyj ściśle dopasowanej maski do niechcianej nakładki w rogu montowanego materiału. Sprawdź klatki, w których osoba lub produkt przechodzi za zaznaczonym obszarem albo ruch kamery zmienia treść widoczną za nim. W tych momentach wypełnienie musi wywnioskować zmieniającą się treść, co może ujawnić migotanie lub zniekształcone krawędzie niewidoczne na pojedynczej klatce podglądu.
Przewodnik po promptach i praktyczne wskazówki
Przygotuj jednoznaczną maskę
Przygotuj maskę PNG wyrównaną do klatki źródłowej: białą wewnątrz obszaru do usunięcia i czarną poza nim. Przed wysłaniem sprawdź położenie na pierwszej, środkowej i ostatniej klatce. Unikaj niepotrzebnie dużych białych obszarów, szczególnie gdy nakładają się na twarz lub ważny szczegół produktu. Maska jest statyczna i wpływa na cały klip; nie może podążać za poruszającymi się napisami ani ograniczyć edycji do wybranego przedziału czasu.
Opisz miejscową edycję i porównaj wynik
Opcjonalna instrukcja, taka jak „Usuń stały pas napisów i wypełnij go otaczającym tłem”, opisuje zamierzoną zmianę bez wymyślania nowej sceny. Porównaj wynik z oryginałem przy normalnej prędkości odtwarzania oraz klatka po klatce w okolicach trudnych ruchów. Oprócz usuniętego obszaru sprawdź obszary bez maski, długość klipu, liczbę klatek na sekundę i dźwięk. Zachowanie oryginalnego dźwięku i zachowanie pikseli poza maską bez żadnych zmian nie zostały zweryfikowane, więc zachowaj plik źródłowy.
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/video-eraser-v1/video-edit",
"input": {
"mask_url": "https://example.com/reference.png",
"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.