Bỏ qua đến nội dung

Sam 3 · Video

Tích hợp

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

Phân đoạn và theo dõi vật thể trong video từ lời nhắc văn bản, điểm hoặc hộp, trả về video có mặt 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 text_prompt · video_output_type · detection_threshold · apply_mask · point_prompts · box_prompts

[ĐÃ LỖI THỜI] Đầu vào cũ được giữ lại để tương thích ngược; hãy dùng 'prompt' thay thế.

video_output_type mặc định X264 (.mp4)

Loại đầu ra của video kết quả.

mặc định 0.5

Ngưỡng độ tin cậy phát hiện; giảm giá trị này sẽ tăng số lượng phát hiện nhưng giảm độ chính xác, trong phạm vi 0.0–1.0.

mặc định []

Tập hợp các lời nhắc dựa trên điểm.

mặc định []

Các lời nhắc hộp được liệt kê dưới dạng bộ tọa độ (x_min, y_min, x_max, y_max).

POST /run/sam-3/video?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?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

Phát hiện và theo dõi các đối tượng trong video được cung cấp qua `video_url`. Nêu tên các mục tiêu trong `prompt`, phân tách bằng dấu phẩy, hoặc dùng `point_prompts` và `box_prompts`. `detection_threshold` nằm trong khoảng từ 0.1 đến 1, còn `apply_mask` kiểm soát việc vẽ mặt nạ lên video. Đầu ra là mp4 hoặc webm, kèm một tệp zip chứa các lớp phủ hộp giới hạn theo từng khung hình.

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.
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'.
text_prompttùy chọn
Kiểustring | null
[ĐÃ LỖI THỜI] Đầu vào cũ được giữ lại để tương thích ngược; hãy dùng 'prompt' thay thế.
point_promptstùy chọn
Kiểuobject[]
Mặc định[]
Tập hợp các lời nhắc dựa trên điểm.
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.
box_promptstùy chọn
Kiểuobject[]
Mặc định[]
Các lời nhắc hộp được liệt kê dưới dạng bộ tọa độ (x_min, y_min, x_max, y_max).
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.
apply_masktùy chọn
Kiểuboolean
Mặc địnhtrue
Có áp dụng mặt nạ cho video hay không.
video_output_typetùy chọn
Kiểuenum
Mặc địnhX264 (.mp4)
X264 (.mp4)VP9 (.webm)
Loại đầu ra của video kết quả.
detection_thresholdtùy chọn
Kiểunumber
Mặc định0.5
0,1 – 1
Ngưỡng độ tin cậy phát hiện; giảm giá trị này sẽ tăng số lượng phát hiện nhưng giảm độ chính xác, trong phạm vi 0.0–1.0.
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",
  "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.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt