Ruka hadi kwenye maudhui

Segment Anything Model 3

Unganisha

Kitambulisho cha modeli 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"

Ombi hili: ≈$ 0.005 salio za API 5 Iendeshe kwenye ukurasa huu

Pata ufunguo wa API
Meta Uhariri wa Picha #segmentation#mask#real-time

Ugawaji wa picha unaoongozwa na maandishi, pointi au kisanduku, unaorejesha picha za maski pamoja na alama na visanduku vya hiari

Meta · Picha

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

chaguomsingi wheel

Maelekezo ya maandishi yanayoongoza ugawaji wa maeneo.

•inahitajika image_url
Dondosha faili, au

URL inayoelekeza kwenye picha ya kugawa maeneo.

Ya kina text_prompt · output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts

[DEPRECATED] Ingizo la zamani lililohifadhiwa kwa uoanifu wa nyuma; tumia 'prompt' badala yake.

output_format chaguomsingi png

Muundo wa faili wa picha inayotokana.

chaguomsingi 3

Kikomo cha juu cha barakoa zinazorudishwa wakati `return_multiple_masks` imewezeshwa.

chaguomsingi []

Mkusanyiko wa vidokezo vinavyotegemea pointi.

chaguomsingi []

Vidokezo vya visanduku ambavyo object_id huamua upangaji: vitambulisho vinavyolingana huunganisha visanduku na kitu kimoja, huku vitambulisho tupu vikiwakilisha vitu tofauti. Visanduku vingi vinaweza kutolewa, kila kimoja kikitumia viwianishi (x_min, y_min, x_max, y_max).

POST /run/sam-3/image?wait=20 makadirio → $ 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"

Endesha ombi hili

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Pata ufunguo wa API

Kuhusu Segment Anything Model 3

Hugawa picha kwa SAM 3 kutoka kwenye `prompt` ya maandishi, `point_prompts` au `box_prompts`. `return_multiple_masks` ikiwezeshwa, hurejesha hadi maski `max_masks` (1 hadi 32). Alama za hiari za uaminifu na visanduku vya mipaka vinaweza kujumuishwa. Muundo wa matokeo ni jpeg, png au webp.

Vigezo

Tuma jina rasmi au jina asilia, si yote mawili. Majina rasmi

JinaAina ChaguomsingiInaruhusiwa Maelezo
image_urlinahitajika image
Ainaurl · image
URL inayoelekeza kwenye picha ya kugawa maeneo.
promptsi lazima
Ainastring
Chaguomsingiwheel
Maelekezo ya maandishi yanayoongoza ugawaji wa maeneo.
text_promptsi lazima
Ainastring | null
[DEPRECATED] Ingizo la zamani lililohifadhiwa kwa uoanifu wa nyuma; tumia 'prompt' badala yake.
point_promptssi lazima
Ainaobject[]
Chaguomsingi[]
Mkusanyiko wa vidokezo vinavyotegemea pointi.
point_prompts[].xsi lazima
Ainainteger | null
Nafasi ya kidokezo kwenye mhimili wa X.
point_prompts[].ysi lazima
Ainainteger | null
Nafasi ya kidokezo kwenye mhimili wa Y.
point_prompts[].labelsi lazima
Ainaenum
01
Lebo ya mandhari ya mbele/mandharinyuma: 1 huonyesha mandhari ya mbele; 0 huonyesha mandharinyuma.
point_prompts[].object_idsi lazima
Ainainteger | null
Kitambulisho cha hiari kinachopanga vidokezo vinavyoboresha kitu kimoja. Ikiwa maandishi pia yametolewa kama kidokezo, kitambulisho hiki huamua ni kitu gani kilichogunduliwa ambacho pointi hizo huboresha.
point_prompts[].frame_indexsi lazima
Ainainteger | null
Faharasa inayotambulisha fremu ya mwingiliano.
box_promptssi lazima
Ainaobject[]
Chaguomsingi[]
Vidokezo vya visanduku ambavyo object_id huamua upangaji: vitambulisho vinavyolingana huunganisha visanduku na kitu kimoja, huku vitambulisho tupu vikiwakilisha vitu tofauti. Visanduku vingi vinaweza kutolewa, kila kimoja kikitumia viwianishi (x_min, y_min, x_max, y_max).
box_prompts[].x_minsi lazima
Ainainteger | null
Koordinati ya chini ya x ya kisanduku.
box_prompts[].y_minsi lazima
Ainainteger | null
Koordinati ya chini ya y ya kisanduku.
box_prompts[].x_maxsi lazima
Ainainteger | null
Kiwianishi cha juu zaidi cha X cha kisanduku.
box_prompts[].y_maxsi lazima
Ainainteger | null
Kiwianishi cha juu zaidi cha Y cha kisanduku.
box_prompts[].object_idsi lazima
Ainainteger | null
Kitambulisho cha hiari kinachopanga visanduku vinavyoboresha kitu kimoja.
box_prompts[].frame_indexsi lazima
Ainainteger | null
Faharasa inayotambulisha fremu ya mwingiliano.
apply_masksi lazima
Ainaboolean
Chaguomsingitrue
Hudhibiti ikiwa picha imewekewa barakoa.
output_formatsi lazima
Ainaenum
Chaguomsingipng
jpegpngwebp
Muundo wa faili wa picha inayotokana.
return_multiple_maskssi lazima
Ainaboolean
Chaguomsingifalse
Chaguo la kurejesha barakoa nyingi: kuliwezesha hutumia `max_masks` kuamua idadi ya barakoa zinazozalishwa za kupakia na kujumuisha kwenye jibu.
max_maskssi lazima
Ainainteger
Chaguomsingi3
1 – 32
Kikomo cha juu cha barakoa zinazorudishwa wakati `return_multiple_masks` imewezeshwa.
include_scoressi lazima
Ainaboolean
Chaguomsingifalse
Hudhibiti kujumuishwa kwa alama za kujiamini za barakoa.
include_boxessi lazima
Ainaboolean
Chaguomsingifalse
Hudhibiti kujumuishwa kwa kisanduku cha mipaka cha kila barakoa, ikiwa kinapatikana.
inahitajika Jina rasmi, pia linakubalika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

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"
  }
}
Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.
Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.
Sehemu za tokeo
image
object {url, content_type, file_name, file_size, width, height} | nullHakikisho linaloonyesha barakoa kuu ya ugawaji wa maeneo.
masks
array of object {url, content_type, file_name, file_size, width, height}Picha zilizo na barakoa za ugawaji wa maeneo.
metadata
array of object {index, score, box} | nullMetadata ya kila maski, ikijumuisha alama yake na kisanduku.
scores
array of number | nullAlama ya kujiamini kwa kila maski, inayotolewa inapoombwa.
boxes
array of array of number | nullVisanduku vilivyorekebishwa kwa kila maski, vilivyoonyeshwa kama [cx, cy, w, h], vikiombwa.

Miundo zaidi: Uhariri wa Picha

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/sam-3/image.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt