Sleppa yfir í efni

Segment Anything Model 3

Tengja

Auðkenni líkans sam-3/image
# 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/sam-3/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Þessi beiðni: ≈0,005 $ 5 API-inneignir Keyra á þessari síðu

Fá API-lykil
Meta Myndvinnsla #segmentation#mask#real-time

Myndskipting með texta-, punkta- eða kassafyrirmælum sem skilar maskamyndum, valfrjálsum stigum og kössum

Meta · Mynd

Fyrsta niðurstaðan þín birtist hér

Búðu til beiðni hér að neðan og keyrðu hana með API-lyklinum þínum. Úttök eru afrituð í geymsluna okkar og geymd að eilífu eða 7 dagar án kostnaðar.

Búa til beiðni

Stýringar eru búnar til út frá líkanaskemanu. Kóðinn og verðið uppfærast þegar þú breytir þeim.

sjálfgefið wheel

Textaleiðbeining sem stýrir hlutgreiningu.

•áskilið image_url
Slepptu skrá eða

Vefslóð sem vísar á myndina fyrir hlutgreiningu.

Ítarlegt text_prompt · output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts

[DEPRECATED] Eldra inntak sem er varðveitt vegna afturvirks samhæfis; notið 'prompt' í staðinn.

output_format sjálfgefið png

Skráarsnið myndarinnar sem verður til.

sjálfgefið 3

Hámarksfjöldi gríma í svari þegar `return_multiple_masks` er virkt.

sjálfgefið []

Safn punktamiðaðra kvaðninga.

sjálfgefið []

Kassakvaðningar þar sem object_id ákvarðar flokkun: samsvarandi auðkenni tengja kassa við einn hlut en tóm auðkenni tákna aðskilda hluti. Hægt er að gefa upp marga kassa, hvern með hnitunum (x_min, y_min, x_max, y_max).

POST /run/sam-3/image?wait=20 verðtilboð → 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/sam-3/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Keyra þessa beiðni

Lykillinn þinn er áfram í þessum vafra: hann er aðeins sendur til Doitong API og vistaður í localStorage aðeins ef þú hakar við Muna. Fá API-lykil

Um Segment Anything Model 3

Skiptir mynd með SAM 3 út frá texta-`prompt`, `point_prompts` eða `box_prompts`. Þegar `return_multiple_masks` er virkt skilar hún allt að `max_masks` möskvum (1 til 32). Valfrjáls öryggisstig og afmörkunarkassar geta fylgt. Úttakssniðið er jpeg, png eða webp.

Færibreytur

Sendu annaðhvort samræmda heitið eða upprunalega heitið, ekki bæði. Samræmd heiti

HeitiGerð SjálfgefiðLeyfilegt Lýsing
image_urláskilið image
Gerðurl · image
Vefslóð sem vísar á myndina fyrir hlutgreiningu.
promptvalfrjálst
Gerðstring
Sjálfgefiðwheel
Textaleiðbeining sem stýrir hlutgreiningu.
text_promptvalfrjálst
Gerðstring | null
[DEPRECATED] Eldra inntak sem er varðveitt vegna afturvirks samhæfis; notið 'prompt' í staðinn.
point_promptsvalfrjálst
Gerðobject[]
Sjálfgefið[]
Safn punktamiðaðra kvaðninga.
point_prompts[].xvalfrjálst
Gerðinteger | null
Staðsetning kvaðningar eftir X-ásnum.
point_prompts[].yvalfrjálst
Gerðinteger | null
Staðsetning kvaðningar eftir Y-ásnum.
point_prompts[].labelvalfrjálst
Gerðenum
01
Merkimiði fyrir forgrunn eða bakgrunn: 1 táknar forgrunn; 0 táknar bakgrunn.
point_prompts[].object_idvalfrjálst
Gerðinteger | null
Valfrjálst auðkenni sem flokkar kvaðningar sem betrumbæta einn hlut. Ef texti er einnig gefinn upp sem kvaðning ákvarðar þetta auðkenni hvaða greindi hlutur punktarnir betrumbæta.
point_prompts[].frame_indexvalfrjálst
Gerðinteger | null
Vísir sem auðkennir rammann fyrir samskipti.
box_promptsvalfrjálst
Gerðobject[]
Sjálfgefið[]
Kassakvaðningar þar sem object_id ákvarðar flokkun: samsvarandi auðkenni tengja kassa við einn hlut en tóm auðkenni tákna aðskilda hluti. Hægt er að gefa upp marga kassa, hvern með hnitunum (x_min, y_min, x_max, y_max).
box_prompts[].x_minvalfrjálst
Gerðinteger | null
Lágmark x-hnits fyrir reitinn.
box_prompts[].y_minvalfrjálst
Gerðinteger | null
Lágmark y-hnits fyrir reitinn.
box_prompts[].x_maxvalfrjálst
Gerðinteger | null
Hámark X-hnits kassans.
box_prompts[].y_maxvalfrjálst
Gerðinteger | null
Hámark Y-hnits kassans.
box_prompts[].object_idvalfrjálst
Gerðinteger | null
Valfrjálst auðkenni sem flokkar kassa sem betrumbæta einn hlut.
box_prompts[].frame_indexvalfrjálst
Gerðinteger | null
Vísir sem auðkennir rammann fyrir samskipti.
apply_maskvalfrjálst
Gerðboolean
Sjálfgefiðtrue
Stýrir því hvort grímu er beitt á myndina.
output_formatvalfrjálst
Gerðenum
Sjálfgefiðpng
jpegpngwebp
Skráarsnið myndarinnar sem verður til.
return_multiple_masksvalfrjálst
Gerðboolean
Sjálfgefiðfalse
Valkostur fyrir skil á mörgum grímum: þegar hann er virkur notar hann `max_masks` til að ákvarða hversu margar myndaðar grímur á að hlaða upp og hafa með í svari.
max_masksvalfrjálst
Gerðinteger
Sjálfgefið3
1 – 32
Hámarksfjöldi gríma í svari þegar `return_multiple_masks` er virkt.
include_scoresvalfrjálst
Gerðboolean
Sjálfgefiðfalse
Stýrir því hvort öryggisstig fyrir grímur séu tekin með.
include_boxesvalfrjálst
Gerðboolean
Sjálfgefiðfalse
Stýrir því hvort afmörkunarreitur fyrir hverja grímu sé tekinn með, ef hann er tiltækur.
áskilið Samræmt heiti, einnig samþykkt

Skrárfæribreytur taka við opinberri https://-vefslóð, data:-URI allt að 10 MB eða file_url fyrir upphleðslu. Skrár

Úttak

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sam-3/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": 5,
    "usd": "0.005",
    "charged": 5,
    "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Skrárnar þínar, þitt valHvert outputs[].url er afrit í geymslunni okkar: geymt að eilífu (greitt fyrir hvert GB-mánuðargildi) eða 7 dagar án kostnaðar, eftir stillingu aðgangsins þíns eða ?storage=.
Sama lögun í öllum líkönumtype, url, content_type, width, height og duration, jafnt fyrir myndir, myndbönd og hljóð. output er eigið niðurstöðuhlutur líkansins.
Reitir úttaks
image
object {url, content_type, file_name, file_size, width, height} | nullForskoðun sem sýnir aðalgrímu hlutgreiningar.
masks
array of object {url, content_type, file_name, file_size, width, height}Myndir sem innihalda grímur hlutgreiningar.
metadata
array of object {index, score, box} | nullLýsigögn fyrir hverja grímu, þar á meðal skor hennar og ramma.
scores
array of number | nullÖryggisskor fyrir hverja grímu, gefið upp þegar þess er óskað.
boxes
array of array of number | nullSamræmdir rammar fyrir hverja grímu, settir fram sem [cx, cy, w, h], ef þess er óskað.

Fleiri líkön: Myndvinnsla

Fyrir gervigreindarþjóna: þessi síða á Markdown-sniði er á https://doitong.com/is/developers/models/sam-3/image.md. Öll líkön og leiðbeiningar: https://doitong.com/developers/llms.txt