Vai al contenuto

Extract Object

Integra

ID del modello 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"

Questa richiesta: 0,02 $ 20 crediti API Esegui in questa pagina

Ottieni la chiave API
Bria AI · Immagine

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

Oggetto su cui agire, descritto in linguaggio naturale, come 'the red car'.

Avanzate image · autocrop · remove_background
image_url predefinito https://bria-datasets...
Trascina un file oppure

Immagine sorgente fornita tramite URL pubblico, byte dell’immagine codificati in base64 o URI dati base64 come data:image/png;base64,... .

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

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Extract Object

Trova nell'immagine di `image_url` l'oggetto descritto in `prompt` e lo restituisce su uno sfondo trasparente, insieme alla maschera di segmentazione. `autocrop` riduce la tela alle dimensioni dell'oggetto. `remove_background` perfeziona il bordo del ritaglio rimuovendo lo sfondo invece di usare solo la maschera di segmentazione. Se non trova corrispondenze, restituisce l'immagine di input completa.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
image_urlfacoltativo image
Tipourl · image
Predefinitohttps://bria-datasets.s3.amazonaws.com/object-extraction/tools_construction_flatlay.jpg
Immagine sorgente fornita tramite URL pubblico, byte dell’immagine codificati in base64 o URI dati base64 come data:image/png;base64,... .
promptfacoltativo
Tipostring
Predefinitoyellow hammer
Oggetto su cui agire, descritto in linguaggio naturale, come 'the red car'.
autocropfacoltativo
Tipoboolean
Predefinitofalse
Ritaglia la tela di output per adattarla all’oggetto estratto.
remove_backgroundfacoltativo
Tipoboolean
Predefinitofalse
Interruttore per il perfezionamento alfa del ritaglio. Il valore predefinito, False, ignora il matting dell’oggetto saliente e prende direttamente l’alfa dalla segmentazione SAM, rendendo l’elaborazione più rapida e aiutando a preservare testo, loghi o elementi grafici che RMBG potrebbe ritagliare eccessivamente. Imposta True per perfezionare l’alfa usando la rimozione dello sfondo di RMBG.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
image
object {url, content_type, file_name, file_size, width, height}Immagine sorgente completa se il prompt non trova alcun oggetto corrispondente; altrimenti, un risultato RGBA con l’oggetto estratto circondato dalla trasparenza.
mask
object {url, content_type, file_name, file_size, width, height}Maschera di estrazione il cui fallback in caso di mancata corrispondenza dipende dall’input: le immagini RGBA forniscono il proprio canale alfa, mentre tutte le altre immagini producono una maschera completamente bianca.

Altri modelli: Modifica immagini

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/bria/extract-object.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt