Bỏ qua đến nội dung

Void Video Inpainting

Tích hợp

Id mô hình 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"

Các tệp như ví dụ: 0,10 $ 100 tín dụng API tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
Open model Video sang video #utility#editing

Xóa một vật thể khỏi video cùng các ảnh hưởng của vật thể đó lên cảnh, bằng video mặt nạ hoặc lời nhắc mặt nạ văn bản

Open model · Video

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc

Mô tả chỉ rõ nền sẽ trông như thế nào sau khi đối tượng được xóa.

•bắt buộc video_url
Thả tệp hoặc

URL video nguồn chứa đối tượng cần xóa.

mặc định
Thả tệp hoặc

URL video mặt nạ xóa; nếu không có, ứng dụng sẽ tạo mặt nạ video tạm thời qua điểm cuối video SAM-3 bằng `mask_prompt`, sau đó tự động chuyển thành quadmask. Để có kết quả tốt nhất, hãy cung cấp quadmask kiểu VOID với 4 giá trị thang độ xám: 255 cho nền được giữ lại, 127 cho vùng bị ảnh hưởng, 63 cho phần chồng lấn và 0 cho đối tượng bị xóa. Mặt nạ nhị phân cũng được chấp nhận, dùng 255 để giữ và 0 để xóa.

Nâng cao mask_prompt · negative_prompt · num_inference_steps · guidance_scale · strength · num_frames · seed · enable_safety_checker

Hướng dẫn xác định mục tiêu mặt nạ cho SAM-3 để tạo video mặt nạ tạm thời khi không cung cấp `quad_mask_video_url`. Xác định nội dung cần tạo mặt nạ, chẳng hạn đối tượng hoặc người cần xóa khỏi video nguồn.

mặc định The video is not of a...

Lời nhắc phủ định mô tả các kết quả không mong muốn để hướng quá trình tạo sinh tránh chúng.

mặc định 30

Số bước khử nhiễu. Tăng giá trị này cải thiện chất lượng nhưng làm tăng độ trễ.

mặc định 1

Cường độ hướng dẫn không có bộ phân loại.

mặc định 1

Độ mạnh khử nhiễu, trong đó 1.0 biểu thị khử nhiễu hoàn toàn.

mặc định 85

Cửa sổ suy luận theo thời gian được yêu cầu, được backend điều chỉnh thành một trong các kích thước an toàn cho CogVideoX 69, 77, 85, ..., 197. Kích thước gần nhất được chọn để phù hợp với việc nén theo thời gian và phân mảnh.

Seed kiểm soát tính ngẫu nhiên để tái lập kết quả.

POST /run/void-video-inpainting?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Void Video Inpainting

Nhận `video_url` và `prompt` mô tả nền mong muốn. Cung cấp `quad_mask_video_url` hoặc dùng `mask_prompt` để tạo mặt nạ. Các tùy chọn gồm `num_frames` (1-197), `num_inference_steps` (1-50), `guidance_scale`, `strength` và `enable_pass2_refinement` tùy chọn, chậm hơn, để đảm bảo tính nhất quán theo thời gian.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
video_urlbắt buộc video
Kiểuurl · video
URL video nguồn chứa đối tượng cần xóa.
quad_mask_video_urltùy chọn
Kiểuurl · video
Mặc định
URL video mặt nạ xóa; nếu không có, ứng dụng sẽ tạo mặt nạ video tạm thời qua điểm cuối video SAM-3 bằng `mask_prompt`, sau đó tự động chuyển thành quadmask. Để có kết quả tốt nhất, hãy cung cấp quadmask kiểu VOID với 4 giá trị thang độ xám: 255 cho nền được giữ lại, 127 cho vùng bị ảnh hưởng, 63 cho phần chồng lấn và 0 cho đối tượng bị xóa. Mặt nạ nhị phân cũng được chấp nhận, dùng 255 để giữ và 0 để xóa.
mask_prompttùy chọn
Kiểustring | null
Hướng dẫn xác định mục tiêu mặt nạ cho SAM-3 để tạo video mặt nạ tạm thời khi không cung cấp `quad_mask_video_url`. Xác định nội dung cần tạo mặt nạ, chẳng hạn đối tượng hoặc người cần xóa khỏi video nguồn.
promptbắt buộc
Kiểustring
Mô tả chỉ rõ nền sẽ trông như thế nào sau khi đối tượng được xóa.
enable_pass2_refinementtùy chọn
Kiểuboolean
Mặc địnhfalse
Tinh chỉnh VOID tùy chọn, đánh đổi tốc độ xử lý chậm hơn để có khả năng nhất quán theo thời gian tốt hơn trong các đoạn dài. Tùy chọn này áp dụng tinh chỉnh nhiễu đã biến dạng ở Pass 2, sau Pass 1.
negative_prompttùy chọn
Kiểustring
Mặc địnhThe 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.
Lời nhắc phủ định mô tả các kết quả không mong muốn để hướng quá trình tạo sinh tránh chúng.
num_inference_stepstùy chọn
Kiểuinteger
Mặc định30
1 – 50
Số bước khử nhiễu. Tăng giá trị này cải thiện chất lượng nhưng làm tăng độ trễ.
guidance_scaletùy chọn
Kiểunumber
Mặc định1
0 – 20
Cường độ hướng dẫn không có bộ phân loại.
strengthtùy chọn
Kiểunumber
Mặc định1
0 – 1
Độ mạnh khử nhiễu, trong đó 1.0 biểu thị khử nhiễu hoàn toàn.
seedtùy chọn
Kiểuinteger | null
Seed kiểm soát tính ngẫu nhiên để tái lập kết quả.
num_framestùy chọn
Kiểuinteger
Mặc định85
1 – 197
Cửa sổ suy luận theo thời gian được yêu cầu, được backend điều chỉnh thành một trong các kích thước an toàn cho CogVideoX 69, 77, 85, ..., 197. Kích thước gần nhất được chọn để phù hợp với việc nén theo thời gian và phân mảnh.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Bật kiểm tra an toàn cho nội dung được tạo.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
video
object {url, content_type, file_name, file_size}Video kết quả sau khi xóa đối tượng.
seed
integerGiá trị seed được áp dụng trong quá trình tạo sinh.
timings
objectChi tiết thời gian theo từng giai đoạn của pipeline.

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/void-video-inpainting.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt