Skip to content

Segment Anything Model 2 · Auto Segment

Integrate

Model id sam2/auto-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/sam2/auto-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"
  }'

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

This request: ≈$0.014 14 API credits · ≈ ₽1.48 Run it on this page

Get API key
Meta Image Editing #segmentation#mask

Automatic whole-image segmentation that returns individual masks plus a combined mask

Meta · Data (JSON)

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required image_url
Drop a file, or

Image URL for automatic segmentation.

Advanced output_format · points_per_side · pred_iou_thresh · stability_score_thresh · min_mask_region_area
output_format default png

File format for the resulting image.

default 32

Count of sample points along each image side.

default 0.88

Cutoff applied to the predicted IOU score.

default 0.95

Cutoff applied to the stability score.

default 100

Smallest permitted mask region area.

POST /run/sam2/auto-segment?wait=20 quote → $0.014
# 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/sam2/auto-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"
  }'

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

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Segment Anything Model 2 · Auto Segment

Segments an image from `image_url` without any prompts, returning one combined mask and an array of individual masks. Tune detection with `points_per_side` (default 32), `pred_iou_thresh`, `stability_score_thresh` and `min_mask_region_area`. Mask images can be saved as png or jpeg.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
image_urlrequired image
Typeurl · image
Image URL for automatic segmentation.
output_formatoptional
Typeenum
Defaultpng
jpegpng
File format for the resulting image.
points_per_sideoptional
Typeinteger
Default32
Count of sample points along each image side.
pred_iou_threshoptional
Typenumber
Default0.88
Cutoff applied to the predicted IOU score.
stability_score_threshoptional
Typenumber
Default0.95
Cutoff applied to the stability score.
min_mask_region_areaoptional
Typeinteger
Default100
Smallest permitted mask region area.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam2/auto-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": 14,
    "usd": "0.014",
    "charged": 14,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "combined_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
    },
    "individual_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
      }
    ]
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "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"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
combined_mask
object {url, content_type, file_name, file_size, width, height}Segmentation mask combining the results.
individual_masks
array of object {url, content_type, file_name, file_size, width, height}Separate masks for individual segments.

More models: Image Editing

For AI agents: this page as Markdown is at https://doitong.com/en-GB/developers/models/sam2/auto-segment.md. All models and guides: https://doitong.com/developers/llms.txt