콘텐츠로 건너뛰기

Void Video Inpainting

통합

모델 id 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"

예시와 같은 파일: $0.10 100 API 크레딧 실행 전에 파일을 측정합니다 이 페이지에서 실행

API 키 받기
Open model 동영상을 동영상으로 #utility#editing

마스크 동영상 또는 텍스트 마스크 프롬프트를 사용해 장면에 미친 영향까지 포함하여 동영상에서 사물을 제거함

Open model · 동영상

첫 번째 결과가 여기에 표시됩니다

아래에서 요청을 작성하고 API 키로 실행하세요. 출력은 스토리지에 복사되며, 영구 보관하거나 7일 동안 무료로 보관할 수 있습니다.

요청 만들기

컨트롤은 모델 스키마에서 생성됩니다. 값을 변경하면 코드와 가격이 업데이트됩니다.

•필수

객체 제거 후 배경이 어떻게 보여야 하는지 지정하는 설명입니다.

•필수 video_url
파일을 끌어다 놓거나

제거 대상 객체가 포함된 소스 동영상 URL입니다.

기본값
파일을 끌어다 놓거나

제거 마스크 동영상 URL입니다. 제공하지 않으면 앱이 `mask_prompt`를 사용해 SAM-3 동영상 엔드포인트에서 임시 동영상 마스크를 생성한 후 자동으로 쿼드 마스크로 변환합니다. 최상의 결과를 위해 4개의 그레이스케일 값을 사용하는 VOID 스타일 쿼드 마스크를 제공하세요. 유지할 배경은 255, 영향을 받는 영역은 127, 겹침은 63, 제거할 객체는 0입니다. 이진 마스크도 허용되며, 유지에는 255, 제거에는 0을 사용합니다.

고급 mask_prompt · negative_prompt · num_inference_steps · guidance_scale · strength · num_frames · seed · enable_safety_checker

`quad_mask_video_url`이 제공되지 않을 때 SAM-3가 임시 마스크 동영상을 생성하도록 하는 마스크 대상 지침입니다. 소스 동영상에서 제거할 객체나 사람 등 마스크할 대상을 지정합니다.

기본값 The video is not of a...

생성이 피해야 할 원치 않는 결과를 설명하는 네거티브 프롬프트입니다.

기본값 30

디노이징 단계 수입니다. 늘리면 품질이 향상되지만 지연 시간이 증가합니다.

기본값 1

분류기 없는 가이던스의 강도입니다.

기본값 1

디노이징 강도이며, 1.0은 완전한 디노이징을 의미합니다.

기본값 85

요청된 시간 추론 창입니다. 백엔드가 CogVideoX에서 안전한 크기 69, 77, 85, ..., 197 중 하나로 조정합니다. 시간 압축과 패칭을 수용할 수 있도록 가장 가까운 크기를 선택합니다.

재현 가능한 결과를 위해 무작위성을 제어하는 시드입니다.

POST /run/void-video-inpainting?wait=20 견적 → $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"

이 요청 실행

키는 이 브라우저에 유지됩니다. Doitong API로만 전송되며, 기억하기를 선택한 경우에만 localStorage에 저장됩니다. API 키 받기

Void Video Inpainting 정보

원하는 배경을 설명하는 `video_url`과 `prompt`를 입력합니다. `quad_mask_video_url`을 제공하거나 `mask_prompt`를 입력해 마스크를 생성할 수 있습니다. `num_frames` (1-197), `num_inference_steps` (1-50), `guidance_scale`, `strength`를 조절할 수 있으며, 시간적 일관성을 위한 더 느린 선택적 `enable_pass2_refinement`도 지원합니다.

매개변수

표준 이름이나 네이티브 이름 중 하나만 보내세요. 표준 이름

이름유형 기본값허용됨 설명
video_url필수 video
유형url · video
제거 대상 객체가 포함된 소스 동영상 URL입니다.
quad_mask_video_url선택 사항
유형url · video
기본값
제거 마스크 동영상 URL입니다. 제공하지 않으면 앱이 `mask_prompt`를 사용해 SAM-3 동영상 엔드포인트에서 임시 동영상 마스크를 생성한 후 자동으로 쿼드 마스크로 변환합니다. 최상의 결과를 위해 4개의 그레이스케일 값을 사용하는 VOID 스타일 쿼드 마스크를 제공하세요. 유지할 배경은 255, 영향을 받는 영역은 127, 겹침은 63, 제거할 객체는 0입니다. 이진 마스크도 허용되며, 유지에는 255, 제거에는 0을 사용합니다.
mask_prompt선택 사항
유형string | null
`quad_mask_video_url`이 제공되지 않을 때 SAM-3가 임시 마스크 동영상을 생성하도록 하는 마스크 대상 지침입니다. 소스 동영상에서 제거할 객체나 사람 등 마스크할 대상을 지정합니다.
prompt필수
유형string
객체 제거 후 배경이 어떻게 보여야 하는지 지정하는 설명입니다.
enable_pass2_refinement선택 사항
유형boolean
기본값false
더 긴 클립에서 처리 속도를 늦추는 대신 시간적 일관성을 개선할 수 있는 선택적 VOID 보정입니다. Pass 1 다음에 Pass 2로 변형 노이즈 보정을 적용합니다.
negative_prompt선택 사항
유형string
기본값The 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.
생성이 피해야 할 원치 않는 결과를 설명하는 네거티브 프롬프트입니다.
num_inference_steps선택 사항
유형integer
기본값30
1 – 50
디노이징 단계 수입니다. 늘리면 품질이 향상되지만 지연 시간이 증가합니다.
guidance_scale선택 사항
유형number
기본값1
0 – 20
분류기 없는 가이던스의 강도입니다.
strength선택 사항
유형number
기본값1
0 – 1
디노이징 강도이며, 1.0은 완전한 디노이징을 의미합니다.
seed선택 사항
유형integer | null
재현 가능한 결과를 위해 무작위성을 제어하는 시드입니다.
num_frames선택 사항
유형integer
기본값85
1 – 197
요청된 시간 추론 창입니다. 백엔드가 CogVideoX에서 안전한 크기 69, 77, 85, ..., 197 중 하나로 조정합니다. 시간 압축과 패칭을 수용할 수 있도록 가장 가까운 크기를 선택합니다.
enable_safety_checker선택 사항
유형boolean
기본값true
생성된 콘텐츠의 안전 검사를 활성화합니다.
필수 표준 이름, 사용 가능

파일 매개변수에는 공개 https:// URL, 최대 10 MB의 data: URI 또는 업로드의 file_url을 사용할 수 있습니다. 파일

출력

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"
  }
}
파일 보관 방식 선택모든 outputs[].url은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 7일 동안 무료로 보관합니다.
모든 모델에서 동일한 구조이미지, 동영상, 오디오 모두 type, url, content_type, width, height 및 duration을 사용합니다. output은 모델 자체의 결과 객체입니다.
출력 필드
video
object {url, content_type, file_name, file_size}객체를 제거한 후의 결과 동영상입니다.
seed
integer생성 중 적용되는 시드 값입니다.
timings
object파이프라인의 단계별 시간 세부 정보입니다.

AI 에이전트용: 이 페이지의 Markdown 버전: https://doitong.com/ko/developers/models/void-video-inpainting.md. 모든 모델 및 가이드: https://doitong.com/developers/llms.txt