Bỏ qua đến nội dung

Extract Object

Tích hợp

Id mô hình bria/extract-object
# 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/bria/extract-object?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "yellow hammer"
  }'

# 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,02 $ 20 tín dụng API Chạy trên trang này

Lấy khóa API
Bria AI · 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.

Đối tượng cần tác động, được mô tả bằng ngôn ngữ tự nhiên, chẳng hạn 'the red car'.

Nâng cao image · autocrop · remove_background
image_url mặc định https://bria-datasets...
Thả tệp hoặc

Hình ảnh nguồn được cung cấp qua URL công khai, byte hình ảnh mã hóa base64 thô hoặc URI dữ liệu base64 như data:image/png;base64,... .

POST /run/bria/extract-object?wait=20 báo giá → 0,02 $
# 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/bria/extract-object?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "yellow hammer"
  }'

# 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ề Extract Object

Tìm đối tượng được mô tả trong `prompt` bên trong hình ảnh từ `image_url` và trả về đối tượng trên nền trong suốt cùng với mặt nạ phân đoạn. `autocrop` thu gọn canvas quanh đối tượng. `remove_background` tinh chỉnh mép đối tượng đã tách bằng cách xóa nền thay vì chỉ dùng mặt nạ phân đoạn. Nếu không có đối tượng phù hợp, trả về toàn bộ hình ảnh đầu vào.

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_urltùy chọn image
Kiểuurl · image
Mặc địnhhttps://bria-datasets.s3.amazonaws.com/object-extraction/tools_construction_flatlay.jpg
Hình ảnh nguồn được cung cấp qua URL công khai, byte hình ảnh mã hóa base64 thô hoặc URI dữ liệu base64 như data:image/png;base64,... .
prompttùy chọn
Kiểustring
Mặc địnhyellow hammer
Đối tượng cần tác động, được mô tả bằng ngôn ngữ tự nhiên, chẳng hạn 'the red car'.
autocroptùy chọn
Kiểuboolean
Mặc địnhfalse
Cắt canvas đầu ra để vừa với đối tượng được tách.
remove_backgroundtùy chọn
Kiểuboolean
Mặc địnhfalse
Công tắc tinh chỉnh alpha của đối tượng tách. Mặc định, False, bỏ qua việc tách nền đối tượng nổi bật và lấy alpha trực tiếp từ phân đoạn SAM, giúp xử lý nhanh hơn và bảo toàn văn bản, logo hoặc đồ họa mà RMBG có thể cắt quá mức. Đặt True để tinh chỉnh alpha bằng cách xóa nền RMBG.
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": "bria/extract-object",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "prompt": "yellow hammer"
  },
  "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
    },
    "mask": {
      "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
    }
  },
  "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}Toàn bộ hình ảnh nguồn nếu lời nhắc không tìm thấy đối tượng phù hợp; nếu không, là kết quả RGBA với đối tượng được tách bao quanh bởi vùng trong suốt.
mask
object {url, content_type, file_name, file_size, width, height}Mặt nạ tách; phương án dự phòng khi không khớp phụ thuộc vào đầu vào: hình ảnh RGBA cung cấp kênh alpha, còn mọi hình ảnh khác tạo mặt nạ hoàn toàn màu trắng.

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/bria/extract-object.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt