Přejít na obsah

Extract Object

Integrace

ID modelu 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"

Tento požadavek: 0,02 $ 20 kreditů API Spustit na této stránce

Získat API klíč
Bria AI · Obrázek

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

Objekt, na který se má působit, popsaný běžným jazykem, například „the red car“.

Pokročilé image · autocrop · remove_background
image_url výchozí https://bria-datasets...
Přetáhněte soubor nebo

Zdrojový obrázek zadaný prostřednictvím veřejné URL, surových bajtů obrázku kódovaných base64 nebo datového URI base64, například data:image/png;base64,... .

POST /run/bria/extract-object?wait=20 cena → 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"

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu Extract Object

Najde v obrázku z `image_url` objekt popsaný v `prompt` a vrátí jej na průhledném pozadí společně se segmentační maskou. `autocrop` ořízne plátno těsně kolem objektu. `remove_background` zpřesní okraj výřezu odstraněním pozadí namísto použití samotné segmentační masky. Pokud nic neodpovídá, vrátí se celý vstupní obrázek.

Parametry

Odešlete buď kanonický název, nebo nativní název, ne oba. Kanonické názvy

NázevTyp VýchozíPovolené Popis
image_urlvolitelné image
Typurl · image
Výchozíhttps://bria-datasets.s3.amazonaws.com/object-extraction/tools_construction_flatlay.jpg
Zdrojový obrázek zadaný prostřednictvím veřejné URL, surových bajtů obrázku kódovaných base64 nebo datového URI base64, například data:image/png;base64,... .
promptvolitelné
Typstring
Výchozíyellow hammer
Objekt, na který se má působit, popsaný běžným jazykem, například „the red car“.
autocropvolitelné
Typboolean
Výchozífalse
Ořízne výstupní plátno tak, aby odpovídalo extrahovanému objektu.
remove_backgroundvolitelné
Typboolean
Výchozífalse
Přepínač zpřesnění alfa kanálu výřezu. Výchozí hodnota False přeskočí matting výrazného objektu a převezme alfa kanál přímo ze segmentace SAM, čímž urychlí zpracování a pomůže zachovat text, loga nebo grafiku, které by RMBG mohlo nadměrně oříznout. Nastavením True se alfa kanál zpřesní pomocí odstranění pozadí RMBG.
povinné Kanonický název, také podporován

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

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"
  }
}
Vaše soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
image
object {url, content_type, file_name, file_size, width, height}Celý zdrojový obrázek, pokud prompt nenajde odpovídající objekt; jinak výsledek RGBA s extrahovaným objektem obklopeným průhledností.
mask
object {url, content_type, file_name, file_size, width, height}Maska extrakce, jejíž náhradní výsledek při nenalezení objektu závisí na vstupu: obrázky RGBA poskytnou svůj alfa kanál, zatímco všechny ostatní obrázky vytvoří zcela bílou masku.

Další modely: Úprava obrázků

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/bria/extract-object.md. Všechny modely a návody: https://doitong.com/developers/llms.txt