Lumaktaw sa nilalaman

Sam 3 1 · Image

I-integrate

ID ng modelo sam-3-1/image
# 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/sam-3-1/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Kahilingang ito: ≈$0.01 10 kredito ng API · ≈ ₽1.07 Patakbuhin ito sa page na ito

Kumuha ng API key
Meta Pag-edit ng Larawan #segmentation#mask#real-time

SAM 3.1 larawan segmentation mula sa teksto, point o box prompts, na nagbabalik ng mga mask na larawan

Meta · Larawan

Dito mapupunta ang iyong unang resulta

Bumuo ng kahilingan sa ibaba at patakbuhin ito gamit ang iyong API key. Kinokopya ang mga output sa aming storage, na pinananatili nang walang hanggan o 7 araw nang libre.

Bumuo ng kahilingan

Ang mga control ay binubuo mula sa schema ng modelo. Nagbabago ang code at presyo habang ina-adjust mo ang mga ito.

default na wheel

Text instruction na gumagabay sa segmentation.

•kinakailangan image_url
Mag-drop ng file, o

URL ng larawang ise-segment.

advanced output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts
output_format default na png

File format ng resultang larawan.

default na 3

Pinakamataas na bilang ng ibabalik na mask kapag naka-enable ang `return_multiple_masks`.

default na []

Collection ng mga point-based prompt.

default na []

Mga box prompt na ang object_id ang tumutukoy sa pagpapangkat: iniuugnay ng magkaparehong ID ang mga box sa isang object, habang ang mga walang laman na ID ay kumakatawan sa magkakahiwalay na object. Maaaring magbigay ng maraming box, bawat isa gamit ang coordinates (x_min, y_min, x_max, y_max).

POST /run/sam-3-1/image?wait=20 presyo → $0.01
# 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/sam-3-1/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Patakbuhin ang kahilingang ito

Nananatili ang iyong key sa browser na ito: ipinapadala lamang ito sa Doitong API at sine-save (localStorage) lamang kung pipiliin mo ang Tandaan. Kumuha ng API key

Tungkol sa Sam 3 1 · Image

Nagsasagawa ng segmentation sa isang larawan gamit ang SAM 3.1 at teksto na `prompt`, `point_prompts` o `box_prompts`. Maaaring pagsama-samahin ang ilang box bawat object gamit ang object_id. Nagbabalik ang `return_multiple_masks` ng hanggang `max_masks` na mask (1 hanggang 32), na may opsyonal na scores at bounding boxes. Ang output format ay jpeg, png o webp.

Mga parameter

Ipadala ang canonical na pangalan o ang native na pangalan, hindi pareho. Mga canonical na pangalan

PangalanUri defaultPinapayagan Paglalarawan
image_urlkinakailangan image
Uriurl · image
URL ng larawang ise-segment.
promptopsyonal
Uristring
defaultwheel
Text instruction na gumagabay sa segmentation.
point_promptsopsyonal
Uriobject[]
default[]
Collection ng mga point-based prompt.
point_prompts[].xopsyonal
Uriinteger | null
Posisyon ng prompt sa X axis.
point_prompts[].yopsyonal
Uriinteger | null
Posisyon ng prompt sa Y axis.
point_prompts[].labelopsyonal
Urienum
01
Label ng foreground/background: foreground ang tinutukoy ng 1; background ang 0.
point_prompts[].object_idopsyonal
Uriinteger | null
Opsyonal na identifier na nagpapangkat sa mga prompt na nagre-refine ng iisang object. Kung may text ding ibinigay bilang prompt, tinutukoy ng identifier na ito kung aling nadetect na object ang nire-refine ng mga point na iyon.
point_prompts[].frame_indexopsyonal
Uriinteger | null
Index na tumutukoy sa frame para sa interaction.
box_promptsopsyonal
Uriobject[]
default[]
Mga box prompt na ang object_id ang tumutukoy sa pagpapangkat: iniuugnay ng magkaparehong ID ang mga box sa isang object, habang ang mga walang laman na ID ay kumakatawan sa magkakahiwalay na object. Maaaring magbigay ng maraming box, bawat isa gamit ang coordinates (x_min, y_min, x_max, y_max).
box_prompts[].x_minopsyonal
Uriinteger | null
Pinakamababang x-coordinate para sa box.
box_prompts[].y_minopsyonal
Uriinteger | null
Pinakamababang y-coordinate para sa box.
box_prompts[].x_maxopsyonal
Uriinteger | null
Pinakamataas na X coordinate para sa box.
box_prompts[].y_maxopsyonal
Uriinteger | null
Pinakamataas na Y coordinate para sa box.
box_prompts[].object_idopsyonal
Uriinteger | null
Opsyonal na identifier na nagpapangkat sa mga box na nagre-refine ng iisang object.
box_prompts[].frame_indexopsyonal
Uriinteger | null
Index na tumutukoy sa frame para sa interaction.
apply_maskopsyonal
Uriboolean
defaulttrue
Kinokontrol kung ilalapat ang mask sa larawan.
output_formatopsyonal
Urienum
defaultpng
jpegpngwebp
File format ng resultang larawan.
return_multiple_masksopsyonal
Uriboolean
defaultfalse
Opsyon para sa pagbabalik ng maraming mask: kapag naka-enable, ginagamit nito ang `max_masks` upang tukuyin kung ilang nabuong mask ang ia-upload at isasama sa response.
max_masksopsyonal
Uriinteger
default3
1 – 32
Pinakamataas na bilang ng ibabalik na mask kapag naka-enable ang `return_multiple_masks`.
include_scoresopsyonal
Uriboolean
defaultfalse
Kinokontrol kung isasama ang confidence score para sa mga mask.
include_boxesopsyonal
Uriboolean
defaultfalse
Kinokontrol kung isasama ang bounding box para sa bawat mask, kung available.
kinakailangan Canonical na pangalan, tinatanggap din

Tumatanggap ang mga parameter ng file ng pampublikong https:// URL, data: URI na hanggang 10 MB, o file_url ng isang upload. Mga file

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3-1/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": 10,
    "usd": "0.01",
    "charged": 10,
    "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Ikaw ang pumipili para sa iyong mga fileAng bawat outputs[].url ay kopya sa aming storage: pinananatili nang walang hanggan (sinisingil bawat GB-month) o 7 araw nang libre, ayon sa setting ng iyong account o ?storage=.
Parehong shape sa bawat modelotype, url, content_type, width, height at duration, para sa mga larawan, video at audio. Ang output ay sariling result object ng modelo.
Mga field ng output
image
object {url, content_type, file_name, file_size, width, height} | nullPreview na nagpapakita ng pangunahing segmentation mask.
masks
array of object {url, content_type, file_name, file_size, width, height}Mga larawang naglalaman ng segmentation mask.
metadata
array of object {index, score, box} | nullMetadata para sa bawat mask, kasama ang score at box nito.
scores
array of number | nullConfidence score para sa bawat mask, ibinibigay kapag hiniling.
boxes
array of array of number | nullMga normalized box para sa bawat mask, ipinapahayag bilang [cx, cy, w, h], kung hiniling.

Higit pang modelo: Pag-edit ng Larawan

Para sa mga AI agent: nasa Markdown ang pahinang ito sa https://doitong.com/fil/developers/models/sam-3-1/image.md. Lahat ng modelo at gabay: https://doitong.com/developers/llms.txt