Siirry sisältöön

Segment Anything Model 3

Integroi

Mallin tunniste 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"

Tämä pyyntö: ≈0,005 $ 5 API-krediittiä Suorita tällä sivulla

Hanki API-avain
Meta Kuvan muokkaus #segmentation#mask#real-time

Teksti-, piste- tai laatikkokehotteella ohjattu kuvan segmentointi, joka palauttaa maskikuvat sekä valinnaiset pisteet ja laatikot

Meta · Kuva

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

oletus wheel

Segmentointia ohjaava tekstiohje.

•pakollinen image_url
Pudota tiedosto tai

Segmentoitavaan kuvaan osoittava URL-osoite.

Lisäasetukset text_prompt · output_format · max_masks · apply_mask · return_multiple_masks · include_scores · include_boxes · point_prompts · box_prompts

[DEPRECATED] Yhteensopivuuden vuoksi säilytetty vanha syöte; käytä sen sijaan 'prompt'-arvoa.

output_format oletus png

Tulostekuvan tiedostomuoto.

oletus 3

Palautettavien maskien enimmäismäärä, kun `return_multiple_masks` on käytössä.

oletus []

Pistepohjaisten kehotteiden kokoelma.

oletus []

Laatikot, joiden object_id määrittää ryhmittelyn: vastaavat tunnisteet liittävät laatikot yhteen objektiin, kun taas tyhjät tunnisteet edustavat erillisiä objekteja. Laatikoita voi toimittaa useita, ja kunkin koordinaatit ovat (x_min, y_min, x_max, y_max).

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

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Segment Anything Model 3

Segmentoi kuvan SAM 3:lla käyttäen tekstin `prompt`-kehotetta, parametreja `point_prompts` tai `box_prompts`. Kun `return_multiple_masks` on käytössä, palautetaan enintään `max_masks` maskia (1–32). Mukaan voidaan liittää valinnaiset luottamuspisteet ja rajauslaatikot. Tulostemuoto on jpeg, png tai webp.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
image_urlpakollinen image
Tyyppiurl · image
Segmentoitavaan kuvaan osoittava URL-osoite.
promptvalinnainen
Tyyppistring
Oletuswheel
Segmentointia ohjaava tekstiohje.
text_promptvalinnainen
Tyyppistring | null
[DEPRECATED] Yhteensopivuuden vuoksi säilytetty vanha syöte; käytä sen sijaan 'prompt'-arvoa.
point_promptsvalinnainen
Tyyppiobject[]
Oletus[]
Pistepohjaisten kehotteiden kokoelma.
point_prompts[].xvalinnainen
Tyyppiinteger | null
Kehotteen sijainti X-akselilla.
point_prompts[].yvalinnainen
Tyyppiinteger | null
Kehotteen sijainti Y-akselilla.
point_prompts[].labelvalinnainen
Tyyppienum
01
Etuala-/taustatunniste: 1 tarkoittaa etualaa ja 0 taustaa.
point_prompts[].object_idvalinnainen
Tyyppiinteger | null
Valinnainen tunniste, joka ryhmittelee yhtä objektia tarkentavat kehotteet. Jos kehote toimitetaan myös tekstinä, tämä tunniste määrittää, minkä havaitun objektin pisteitä tarkennetaan.
point_prompts[].frame_indexvalinnainen
Tyyppiinteger | null
Vuorovaikutuksessa käytettävän ruudun yksilöivä indeksi.
box_promptsvalinnainen
Tyyppiobject[]
Oletus[]
Laatikot, joiden object_id määrittää ryhmittelyn: vastaavat tunnisteet liittävät laatikot yhteen objektiin, kun taas tyhjät tunnisteet edustavat erillisiä objekteja. Laatikoita voi toimittaa useita, ja kunkin koordinaatit ovat (x_min, y_min, x_max, y_max).
box_prompts[].x_minvalinnainen
Tyyppiinteger | null
Laatikon x-koordinaatin vähimmäisarvo.
box_prompts[].y_minvalinnainen
Tyyppiinteger | null
Laatikon y-koordinaatin vähimmäisarvo.
box_prompts[].x_maxvalinnainen
Tyyppiinteger | null
Laatikon suurin X-koordinaatti.
box_prompts[].y_maxvalinnainen
Tyyppiinteger | null
Laatikon suurin Y-koordinaatti.
box_prompts[].object_idvalinnainen
Tyyppiinteger | null
Valinnainen tunniste yhtä objektia tarkentavien laatikoiden ryhmittelyyn.
box_prompts[].frame_indexvalinnainen
Tyyppiinteger | null
Vuorovaikutuksessa käytettävän ruudun yksilöivä indeksi.
apply_maskvalinnainen
Tyyppiboolean
Oletustrue
Määrittää, käytetäänkö kuvaan maskia.
output_formatvalinnainen
Tyyppienum
Oletuspng
jpegpngwebp
Tulostekuvan tiedostomuoto.
return_multiple_masksvalinnainen
Tyyppiboolean
Oletusfalse
Useiden maskien palautusasetus: käyttöönotettuna se käyttää `max_masks`-arvoa määrittämään, kuinka monta generoitua maskia ladataan ja sisällytetään vastaukseen.
max_masksvalinnainen
Tyyppiinteger
Oletus3
1 – 32
Palautettavien maskien enimmäismäärä, kun `return_multiple_masks` on käytössä.
include_scoresvalinnainen
Tyyppiboolean
Oletusfalse
Määrittää, sisällytetäänkö maskien luottamuspisteet.
include_boxesvalinnainen
Tyyppiboolean
Oletusfalse
Määrittää, sisällytetäänkö kullekin maskille rajauslaatikko, jos se on saatavilla.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
image
object {url, content_type, file_name, file_size, width, height} | nullEsikatselu ensisijaisesta segmentointimaskista.
masks
array of object {url, content_type, file_name, file_size, width, height}Segmentointimaskeja sisältävät kuvat.
metadata
array of object {index, score, box} | nullKunkin maskin metatiedot, mukaan lukien sen pistemäärä ja laatikko.
scores
array of number | nullKunkin maskin luottamuspistemäärä, joka toimitetaan pyydettäessä.
boxes
array of array of number | nullKunkin maskin normalisoidut laatikot muodossa [cx, cy, w, h], jos pyydetty.

Lisää malleja: Kuvan muokkaus

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/sam-3/image.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt