Skip to content

EVF-SAM2 Segmentation

Integrate

Model id evf-sam
# 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/evf-sam?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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"

This request: $0.005 5 API credits Run it on this page

Get API key
Open model Image Editing #segmentation#mask

Text-guided image segmentation that returns masks from positive and negative prompts

Open model · Image

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

Prompt used to produce segmentation.

Regions excluded from segmentation by subtracting them from the prompt's results.

•required image_url
Drop a file, or

Input image URL.

Advanced blur_mask · expand_mask · semantic_type · mask_only · use_grounding_dino · revert_mask · fill_holes
default 0

Gaussian blur kernel size for the mask; the value must be odd.

default 0

Dilate the mask outward by the given pixel count.

POST /run/evf-sam?wait=20 quote → $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/evf-sam?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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"

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 EVF-SAM2 Segmentation

Segments regions of an image described by `prompt`, with `negative_prompt` subtracting areas. Options include `semantic_type`, `use_grounding_dino`, `revert_mask`, `fill_holes`, `blur_mask` (0 to 50) and `expand_mask` (0 to 20). `mask_only` defaults to true and returns a binary mask rather than the masked image.

Parameters

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

NameType DefaultAllowed Description
promptrequired
Typestring
Prompt used to produce segmentation.
negative_promptoptional
Typestring | null
Regions excluded from segmentation by subtracting them from the prompt's results.
semantic_typeoptional
Typeboolean
Defaultfalse
Enable semantic segmentation of body parts, backgrounds, or multiple objects.
image_urlrequired image
Typeurl · image
Input image URL.
mask_onlyoptional
Typeboolean
Defaulttrue
Return just the binary mask rather than the masked image.
use_grounding_dinooptional
Typeboolean
Defaultfalse
Segmentation uses GroundingDINO rather than SAM.
revert_maskoptional
Typeboolean
Defaultfalse
Reverse the mask, swapping foreground and background.
blur_maskoptional
Typeinteger
Default0
0 – 50
Gaussian blur kernel size for the mask; the value must be odd.
expand_maskoptional
Typeinteger
Default0
0 – 20
Dilate the mask outward by the given pixel count.
fill_holesoptional
Typeboolean
Defaultfalse
Use morphological operations to fill mask holes.
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": "evf-sam",
  "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": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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
    }
  },
  "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"
  }
}
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
image
object {url, content_type, file_name, file_size}Image produced by segmentation.

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