Bỏ qua đến nội dung

Moondream3 Preview [Segment]

Tích hợp

Id mô hình moondream3-preview/segment
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/moondream3-preview/segment?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",
    "object": "fox"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Yêu cầu này: ≈0,003 $ 3 tín dụng API · ≈ 0,32 ₽ Chạy trên trang này

Lấy khóa API
Moondream Chỉnh sửa hình ảnh Đầu vào tham chiếu #mask#segmentation

Phân đoạn một đối tượng được chỉ định trong hình ảnh, trả về mặt nạ, hộp giới hạn và đường dẫn SVG

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

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

URL trỏ đến hình ảnh cần xử lý.

•bắt buộc

Đối tượng mục tiêu cần phân đoạn trong hình ảnh.

Nâng cao preview · spatial_references · settings

Hướng dẫn không gian cho phân đoạn, được cung cấp dưới dạng danh sách các đối tượng Point có các thành viên x và y, hoặc danh sách các mảng tọa độ. Mỗi mảng phải chứa 2 số thực (x,y) hoặc 4 số thực (x1,y1,x2,y2).

Cài đặt mô hình phân đoạn điều khiển việc lấy mẫu.

POST /run/moondream3-preview/segment?wait=20 báo giá → 0,003 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/moondream3-preview/segment?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",
    "object": "fox"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/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ề Moondream3 Preview [Segment]

Phân đoạn đối tượng được cung cấp trong `object` bên trong hình ảnh tại `image_url`. Kết quả có thể bao gồm hình ảnh mặt nạ, hộp giới hạn và dữ liệu đường dẫn SVG; các giá trị này là null nếu không phát hiện được gì. `spatial_references` có thể cung cấp các điểm để định hướng việc phân đoạn, còn `settings` điều chỉnh việc lấy mẫu. Đặt `preview` để nhận mặt nạ nhị phân.

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 xử lý.
objectbắt buộc
Kiểustring
Đối tượng mục tiêu cần phân đoạn trong hình ảnh.
spatial_referencestùy chọn
Kiểuany[]
Hướng dẫn không gian cho phân đoạn, được cung cấp dưới dạng danh sách các đối tượng Point có các thành viên x và y, hoặc danh sách các mảng tọa độ. Mỗi mảng phải chứa 2 số thực (x,y) hoặc 4 số thực (x1,y1,x2,y2).
settingstùy chọn
Kiểuobject
Cài đặt mô hình phân đoạn điều khiển việc lấy mẫu.
settings.temperaturetùy chọn
Kiểunumber
Mặc định1
0 – 1
Nhiệt độ lấy mẫu thiết lập sự cân bằng giữa đầu ra tập trung, xác định ở cài đặt thấp và tính ngẫu nhiên cao hơn ở cài đặt cao.
settings.top_ptùy chọn
Kiểunumber
Mặc định1
0 – 1
Khối lượng xác suất cho lấy mẫu nucleus, nằm trong khoảng từ 0 đến 1.
settings.max_tokenstùy chọn
Kiểuinteger | null
≥ 1
Giới hạn trên của số token được tạo.
previewtùy chọn
Kiểuboolean
Mặc địnhfalse
Xác định việc trả về mask nhị phân của hình ảnh cùng với bản xem trước đầu ra.
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": "moondream3-preview/segment",
  "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": 3,
    "usd": "0.003",
    "charged": 3,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "object": "fox"
  },
  "output": {
    "finish_reason": "stop",
    "usage_info": {
      "input_tokens": 1,
      "output_tokens": 1,
      "prefill_time_ms": 1.0,
      "decode_time_ms": 1.0,
      "ttft_ms": 1.0
    },
    "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
    },
    "path": "M.657,.996C.610,.984,.529,.938,.447,.875C.411,.848,.363,.815,.341,.802C.188,.714,.093,.623,.038,.511C.011,.455,.000,.406,.000,.340C.000,.269,.006,.234,.025,.186C.051,.123,.092,.079,.161,.042C.240,-0.000,.355,-0.011,.433,.017C.462,.027,.535,.066,.571,.091C.701,.180,.807,.265,.850,.311C.911,.379,.962,.468,.984,.545C.995,.585,.997,.601,.997,.664C.997,.765,.984,.811,.935,.879C.878,.958,.796,1.001,.705,1.000C.685,.999,.664,.998,.657,.996z",
    "bbox": {
      "x_min": 1.0,
      "y_min": 1.0,
      "x_max": 1.0,
      "y_max": 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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
finish_reason
stringLý do quá trình tạo đầu ra kết thúc.
usage_info
object {input_tokens, output_tokens, prefill_time_ms, decode_time_ms, ttft_ms}Chi tiết mức sử dụng của yêu cầu.
image
object {url, content_type, file_name, file_size, width, height} | nullKết quả xem trước phân đoạn: null nếu không yêu cầu tạo bản xem trước hoặc không phát hiện được đối tượng; nếu không, là hình ảnh chứa mask.
path
string | nullDữ liệu đường dẫn SVG được trả về khi phát hiện mask phân đoạn; nếu không, là null.
bbox
object {x_min, y_min, x_max, y_max} | nullBounding box được trả về cho đối tượng đã phát hiện và phân đoạn; nếu không, là null.

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