Przejdź do treści

Void Video Inpainting

Integracja

Identyfikator modelu void-video-inpainting
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/void-video-inpainting?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Pliki takie jak przykład: 0,10 $ 100 kredytów API Twoje pliki są mierzone przed uruchomieniem Uruchom na tej stronie

Uzyskaj klucz API
Open model Wideo na wideo #utility#editing

Usuwa obiekt z filmu wraz z jego wpływem na scenę, używając filmu z maską lub tekstowego promptu maski

Open model · Wideo

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane

Opis określający wygląd tła po usunięciu obiektu.

•wymagane video_url
Upuść plik lub

URL wideo źródłowego zawierającego obiekt przeznaczony do usunięcia.

domyślnie
Upuść plik lub

URL wideo z maską usuwania; jeśli go nie ma, aplikacja tworzy tymczasową maskę wideo za pomocą endpointu wideo SAM-3 z użyciem `mask_prompt`, a następnie automatycznie konwertuje ją na quadmask. Aby uzyskać najlepsze wyniki, podaj quadmask w stylu VOID z 4 wartościami skali szarości: 255 dla zachowanego tła, 127 dla obszaru objętego działaniem, 63 dla nakładania i 0 dla usuwanego obiektu. Akceptowane są również maski binarne, używające 255 do zachowania i 0 do usunięcia.

Zaawansowane mask_prompt · negative_prompt · num_inference_steps · guidance_scale · strength · num_frames · seed · enable_safety_checker

Instrukcje dotyczące obiektu maski dla SAM-3, służące do utworzenia tymczasowego wideo z maską, gdy nie podano `quad_mask_video_url`. Wskaż element do zamaskowania, np. obiekt lub osobę do usunięcia z wideo źródłowego.

domyślnie The video is not of a...

Negatywny prompt opisujący niepożądane wyniki, aby kierować generowanie z dala od nich.

domyślnie 30

Liczba kroków odszumiania. Jej zwiększenie poprawia jakość, ale zwiększa opóźnienie.

domyślnie 1

Siła wskazówek bez klasyfikatora.

domyślnie 1

Siła odszumiania, przy czym 1.0 oznacza pełne odszumianie.

domyślnie 85

Żądane okno wnioskowania czasowego, dostosowywane przez backend do jednego z bezpiecznych dla CogVideoX rozmiarów 69, 77, 85, ..., 197. Wybierany jest najbliższy taki rozmiar, aby uwzględnić kompresję czasową i dzielenie na fragmenty.

Ziarno sterujące losowością w celu uzyskania powtarzalnych wyników.

POST /run/void-video-inpainting?wait=20 wycena → 0,10 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/void-video-inpainting?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o Void Video Inpainting

Przyjmuje `video_url` oraz `prompt` opisujący żądane tło. Podaj `quad_mask_video_url` albo użyj `mask_prompt`, aby wygenerować maskę. Dostępne ustawienia obejmują `num_frames` (1-197), `num_inference_steps` (1-50), `guidance_scale`, `strength` oraz opcjonalne, wolniejsze `enable_pass2_refinement` zapewniające spójność czasową.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
video_urlwymagane video
Typurl · video
URL wideo źródłowego zawierającego obiekt przeznaczony do usunięcia.
quad_mask_video_urlopcjonalne
Typurl · video
Domyślne
URL wideo z maską usuwania; jeśli go nie ma, aplikacja tworzy tymczasową maskę wideo za pomocą endpointu wideo SAM-3 z użyciem `mask_prompt`, a następnie automatycznie konwertuje ją na quadmask. Aby uzyskać najlepsze wyniki, podaj quadmask w stylu VOID z 4 wartościami skali szarości: 255 dla zachowanego tła, 127 dla obszaru objętego działaniem, 63 dla nakładania i 0 dla usuwanego obiektu. Akceptowane są również maski binarne, używające 255 do zachowania i 0 do usunięcia.
mask_promptopcjonalne
Typstring | null
Instrukcje dotyczące obiektu maski dla SAM-3, służące do utworzenia tymczasowego wideo z maską, gdy nie podano `quad_mask_video_url`. Wskaż element do zamaskowania, np. obiekt lub osobę do usunięcia z wideo źródłowego.
promptwymagane
Typstring
Opis określający wygląd tła po usunięciu obiektu.
enable_pass2_refinementopcjonalne
Typboolean
Domyślnefalse
Opcjonalne udoskonalenie VOID, które wymienia wolniejsze przetwarzanie na potencjalnie lepszą spójność czasową w dłuższych klipach. Stosuje udoskonalenie z użyciem zniekształconego szumu jako Pass 2, po Pass 1.
negative_promptopcjonalne
Typstring
DomyślneThe video is not of a high quality, it has a low resolution. Watermark present in each frame. The background is solid. Strange body and strange trajectory. Distortion.
Negatywny prompt opisujący niepożądane wyniki, aby kierować generowanie z dala od nich.
num_inference_stepsopcjonalne
Typinteger
Domyślne30
1 – 50
Liczba kroków odszumiania. Jej zwiększenie poprawia jakość, ale zwiększa opóźnienie.
guidance_scaleopcjonalne
Typnumber
Domyślne1
0 – 20
Siła wskazówek bez klasyfikatora.
strengthopcjonalne
Typnumber
Domyślne1
0 – 1
Siła odszumiania, przy czym 1.0 oznacza pełne odszumianie.
seedopcjonalne
Typinteger | null
Ziarno sterujące losowością w celu uzyskania powtarzalnych wyników.
num_framesopcjonalne
Typinteger
Domyślne85
1 – 197
Żądane okno wnioskowania czasowego, dostosowywane przez backend do jednego z bezpiecznych dla CogVideoX rozmiarów 69, 77, 85, ..., 197. Wybierany jest najbliższy taki rozmiar, aby uwzględnić kompresję czasową i dzielenie na fragmenty.
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Włącza kontrole bezpieczeństwa generowanej zawartości.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "void-video-inpainting",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "seed": 42,
    "timings": {}
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
video
object {url, content_type, file_name, file_size}Wynikowe wideo po usunięciu obiektu.
seed
integerWartość ziarna stosowana podczas generowania.
timings
objectSzczegóły czasowe poszczególnych etapów potoku.

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/void-video-inpainting.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt