Siirry sisältöön

Extract Object

Integroi

Mallin tunniste bria/extract-object
# 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/bria/extract-object?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "yellow hammer"
  }'

# 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,02 $ 20 API-krediittiä Suorita tällä sivulla

Hanki API-avain
Bria AI · 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.

Kohde, johon toimitaan, kuvattuna luonnollisella kielellä, kuten 'the red car'.

Lisäasetukset image · autocrop · remove_background
image_url oletus https://bria-datasets...
Pudota tiedosto tai

Lähdekuva, joka annetaan julkisen URL-osoitteen, raakojen base64-koodattujen kuvatavujen tai data:image/png;base64,...-tyyppisen base64-data-URI:n kautta.

POST /run/bria/extract-object?wait=20 hinta → 0,02 $
# 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/bria/extract-object?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "yellow hammer"
  }'

# 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: Extract Object

Etsii arvossa `image_url` olevasta kuvasta arvossa `prompt` kuvatun objektin ja palauttaa sen läpinäkyvällä taustalla sekä segmentointimaskin. `autocrop` tiivistää kankaan objektin ympärille. `remove_background` viimeistelee irrotuksen reunan taustanpoistolla pelkän segmentointimaskin käytön sijaan. Jos vastaavuutta ei löydy, palautetaan koko syötekuva.

Parametrit

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

NimiTyyppi OletusSallitut Kuvaus
image_urlvalinnainen image
Tyyppiurl · image
Oletushttps://bria-datasets.s3.amazonaws.com/object-extraction/tools_construction_flatlay.jpg
Lähdekuva, joka annetaan julkisen URL-osoitteen, raakojen base64-koodattujen kuvatavujen tai data:image/png;base64,...-tyyppisen base64-data-URI:n kautta.
promptvalinnainen
Tyyppistring
Oletusyellow hammer
Kohde, johon toimitaan, kuvattuna luonnollisella kielellä, kuten 'the red car'.
autocropvalinnainen
Tyyppiboolean
Oletusfalse
Rajaa tulostekankaan irrotetun kohteen ympärille.
remove_backgroundvalinnainen
Tyyppiboolean
Oletusfalse
Irrotuksen alfakanavan tarkennuksen kytkin. Oletus False ohittaa huomiokohteiden matting-käsittelyn ja käyttää alfaa suoraan SAM-segmentoinnista, mikä nopeuttaa käsittelyä ja auttaa säilyttämään tekstin, logot ja grafiikan, joita RMBG saattaisi rajata liikaa. Aseta arvoksi True, jos haluat tarkentaa alfaa RMBG-taustanpoistolla.
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": "bria/extract-object",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "prompt": "yellow hammer"
  },
  "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
    },
    "mask": {
      "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
    }
  },
  "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}Koko lähdekuva, jos kehote ei löydä vastaavaa kohdetta; muuten RGBA-tulos, jossa irrotettua kohdetta ympäröi läpinäkyvyys.
mask
object {url, content_type, file_name, file_size, width, height}Irrotusmaski, jonka osumattoman tuloksen varakäyttäytyminen riippuu syötteestä: RGBA-kuvat toimittavat alfakanavansa, kun taas kaikki muut kuvat tuottavat kokonaan valkoisen maskin.

Lisää malleja: Kuvan muokkaus

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