Bỏ qua đến nội dung

Segment Anything Model 3

Tích hợp

Id mô hình sam-3/image
# 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/image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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"

Yêu cầu này: ≈0,005 $ 5 tín dụng API Chạy trên trang này

Lấy khóa API
Meta Chỉnh sửa hình ảnh #segmentation#mask#real-time

Phân đoạn ảnh theo lời nhắc văn bản, điểm hoặc hộp, trả về ảnh mặt nạ cùng điểm số và hộp tùy chọn

Meta · Hình ảnh

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 wheel

Hướng dẫn bằng văn bản định hướng việc phân đoạn.

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

URL trỏ đến hình ảnh cần phân đoạn.

Nâng cao text_prompt · output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · 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ế.

output_format mặc định png

Định dạng tệp của hình ảnh kết quả.

mặc định 3

Giới hạn trên của số mặt nạ trả về khi `return_multiple_masks` được bật.

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 dạng hộp có object_id xác định việc nhóm: các ID trùng nhau liên kết các hộp với một vật thể, còn ID trống biểu thị các vật thể riêng biệt. Có thể cung cấp nhiều hộp, mỗi hộp dùng tọa độ (x_min, y_min, x_max, y_max).

POST /run/sam-3/image?wait=20 báo giá → 0,005 $
# 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/image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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ề Segment Anything Model 3

Phân đoạn ảnh bằng SAM 3 từ `prompt` văn bản, `point_prompts` hoặc `box_prompts`. Khi bật `return_multiple_masks`, trả về tối đa `max_masks` mặt nạ (từ 1 đến 32). Có thể включ kèm điểm tin cậy và hộp giới hạn tùy chọn. Định dạng đầu ra là jpeg, png hoặc webp.

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ả
image_urlbắt buộc image
Kiểuurl · image
URL trỏ đến hình ảnh cần phân đoạn.
prompttùy chọn
Kiểustring
Mặc địnhwheel
Hướng dẫn bằng văn bản định hướng việc phân đoạn.
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.
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[]
Các lời nhắc dạng hộp có object_id xác định việc nhóm: các ID trùng nhau liên kết các hộp với một vật thể, còn ID trống biểu thị các vật thể riêng biệt. Có thể cung cấp nhiều hộp, mỗi hộp dùng 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.
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 địnhtrue
Kiểm soát việc áp dụng mặt nạ cho hình ảnh.
output_formattùy chọn
Kiểuenum
Mặc địnhpng
jpegpngwebp
Định dạng tệp của hình ảnh kết quả.
return_multiple_maskstùy chọn
Kiểuboolean
Mặc địnhfalse
Tùy chọn trả về nhiều mặt nạ: khi bật, tùy chọn này dùng `max_masks` để xác định số mặt nạ được tạo cần tải lên và đưa vào phản hồi.
max_maskstùy chọn
Kiểuinteger
Mặc định3
1 – 32
Giới hạn trên của số mặt nạ trả về khi `return_multiple_masks` được bật.
include_scorestùy chọn
Kiểuboolean
Mặc địnhfalse
Kiểm soát việc đưa điểm tin cậy của các mặt nạ vào kết quả.
include_boxestùy chọn
Kiểuboolean
Mặc địnhfalse
Kiểm soát việc đưa hộp giới hạn cho từng mặt nạ vào kết quả, nếu có.
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/image",
  "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": 5,
    "usd": "0.005",
    "charged": 5,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    },
    "masks": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "metadata": [
      {
        "index": 1,
        "score": 1.0,
        "box": [
          1.0
        ]
      }
    ],
    "scores": [
      1.0
    ],
    "boxes": [
      [
        1.0
      ]
    ]
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "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
image
object {url, content_type, file_name, file_size, width, height} | nullBản xem trước hiển thị mặt nạ phân đoạn chính.
masks
array of object {url, content_type, file_name, file_size, width, height}Hình ảnh chứa các mặt nạ phân đoạn.
metadata
array of object {index, score, box} | nullSiêu dữ liệu cho từng mặt nạ, bao gồm điểm số và hộp.
scores
array of number | nullĐiểm độ tin cậy cho từng mặt nạ, được cung cấp khi được yêu cầu.
boxes
array of array of number | nullCác hộp được chuẩn hóa cho từng mặt nạ, biểu diễn dưới dạng [cx, cy, w, h], nếu được yêu cầu.

Thêm mô hình: Chỉnh sửa hình ảnh

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