Bỏ qua đến nội dung

Sam 3 · Video RLE

Tích hợp

Id mô hình sam-3/video-rle
# 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/sam-3/video-rle?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"
  }'

# 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,095 $ 95 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
Meta Video sang video #segmentation#mask#real-time#rle

Phân đoạn video với khởi tạo bằng URL mặt nạ, kiểm soát chỉ số khung hình và ngưỡng phát hiện tối thiểu thấp hơn

Meta · 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.

mặc định

Lời nhắc phân đoạn hỗ trợ nhiều đối tượng được theo dõi thông qua các mô tả phân tách bằng dấu phẩy, chẳng hạn như 'person, cloth'.

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

URL video để phân đoạn.

Nâng cao mask · detection_threshold · frame_index · apply_mask · boundingbox_zip · point_prompts · box_prompts
mask_url
Thả tệp hoặc

URL mặt nạ dùng cho lần áp dụng ban đầu.

mặc định 0.5

Ngưỡng độ tin cậy phát hiện, mặc định là 0.5 cho các đối tượng hiện có và 0.7 cho đối tượng mới. Trong phạm vi 0.0–1.0, giá trị nhỏ hơn đánh đổi độ chính xác để có nhiều phát hiện hơn; hãy thử 0.2–0.3 khi lời nhắc văn bản không hiệu quả.

mặc định 0

Chỉ số khung hình dùng cho tương tác ban đầu khi cung cấp mask_url.

mặc định []

Danh sách lời nhắc điểm chỉ định các chỉ số khung hình.

mặc định []

Danh sách lời nhắc hộp, với frame_index tùy chọn cho từng mục.

POST /run/sam-3/video-rle?wait=20 báo giá → 0,095 $
# 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/sam-3/video-rle?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"
  }'

# 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ề Sam 3 · Video RLE

Phân đoạn video bằng SAM 3 qua `prompt` văn bản, lời nhắc điểm hoặc hộp, hoặc mặt nạ ban đầu từ `mask_url` áp dụng tại `frame_index`. `detection_threshold` nằm trong khoảng 0.01 đến 1; các giá trị thấp hơn như 0.2 đến 0.3 có thể hữu ích khi lời nhắc văn bản không hoạt động. Có thể trả về tệp zip hộp giới hạn theo từng khung hình bằng `boundingbox_zip`.

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 để phân đoạn.
mask_urltùy chọn mask
Kiểuurl · image
URL mặt nạ dùng cho lần áp dụng ban đầu.
prompttùy chọn
Kiểustring
Mặc định
Lời nhắc phân đoạn hỗ trợ nhiều đối tượng được theo dõi thông qua các mô tả phân tách bằng dấu phẩy, chẳng hạn như 'person, cloth'.
point_promptstùy chọn
Kiểuobject[]
Mặc định[]
Danh sách lời nhắc điểm chỉ định các chỉ số khung hình.
point_prompts[].xtùy chọn
Kiểuinteger | null
Vị trí lời nhắc trên trục X.
point_prompts[].ytùy chọn
Kiểuinteger | null
Vị trí lời nhắc trên trục Y.
point_prompts[].labeltùy chọn
Kiểuenum
01
Nhãn tiền cảnh/hậu cảnh: 1 biểu thị tiền cảnh; 0 biểu thị hậu cảnh.
point_prompts[].object_idtùy chọn
Kiểuinteger | null
Mã định danh tùy chọn để nhóm các lời nhắc tinh chỉnh một vật thể duy nhất. Nếu cũng cung cấp văn bản làm lời nhắc, mã định danh này xác định vật thể được phát hiện mà các điểm đó sẽ tinh chỉnh.
point_prompts[].frame_indextùy chọn
Kiểuinteger | null
Chỉ mục xác định khung hình dùng để tương tác.
box_promptstùy chọn
Kiểuobject[]
Mặc định[]
Danh sách lời nhắc hộp, với frame_index tùy chọn cho từng mục.
box_prompts[].x_mintùy chọn
Kiểuinteger | null
Tọa độ x tối thiểu của hộp.
box_prompts[].y_mintùy chọn
Kiểuinteger | null
Tọa độ y tối thiểu của hộp.
box_prompts[].x_maxtùy chọn
Kiểuinteger | null
Tọa độ X lớn nhất của hộp.
box_prompts[].y_maxtùy chọn
Kiểuinteger | null
Tọa độ Y lớn nhất của hộp.
box_prompts[].object_idtùy chọn
Kiểuinteger | null
Mã định danh tùy chọn để nhóm các hộp tinh chỉnh một vật thể duy nhất.
box_prompts[].frame_indextùy chọn
Kiểuinteger | null
Chỉ mục xác định khung hình dùng để tương tác.
apply_masktùy chọn
Kiểuboolean
Mặc địnhfalse
Có áp dụng mặt nạ cho video hay không.
boundingbox_ziptùy chọn
Kiểuboolean
Mặc địnhfalse
Có trả về tệp lưu trữ ZIP chứa lớp phủ hộp giới hạn cho từng khung hình hay không.
detection_thresholdtùy chọn
Kiểunumber
Mặc định0.5
0,01 – 1
Ngưỡng độ tin cậy phát hiện, mặc định là 0.5 cho các đối tượng hiện có và 0.7 cho đối tượng mới. Trong phạm vi 0.0–1.0, giá trị nhỏ hơn đánh đổi độ chính xác để có nhiều phát hiện hơn; hãy thử 0.2–0.3 khi lời nhắc văn bản không hiệu quả.
frame_indextùy chọn
Kiểuinteger
Mặc định0
Chỉ số khung hình dùng cho tương tác ban đầu khi cung cấp mask_url.
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": "sam-3/video-rle",
  "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": 95,
    "usd": "0.095",
    "charged": 95,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "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
    },
    "boundingbox_frames_zip": {
      "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
    }
  },
  "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 được tạo từ quá trình phân đoạn.
boundingbox_frames_zip
object {url, content_type, file_name, file_size} | nullTệp lưu trữ ZIP chứa lớp phủ hộp giới hạn cho từng khung hình.

Thêm mô hình: Video sang video

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