Zum Inhalt springen

Extract Object

Integrieren

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

Diese Anfrage: 0,02 $ 20 API-Credits Auf dieser Seite ausführen

API-Schlüssel abrufen
Bria AI · Bild

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

Zu bearbeitendes Objekt, in natürlicher Sprache beschrieben, etwa 'the red car'.

Erweitert image · autocrop · remove_background
image_url Standard https://bria-datasets...
Datei ablegen oder

Quellbild, bereitgestellt über eine öffentliche URL, rohe base64-codierte Bildbytes oder eine Base64-Daten-URI wie data:image/png;base64,... .

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

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über Extract Object

Findet das in `prompt` beschriebene Objekt im Bild unter `image_url` und gibt es zusammen mit der Segmentierungsmaske auf transparentem Hintergrund zurück. `autocrop` beschneidet die Arbeitsfläche eng um das Objekt. `remove_background` verfeinert die Kante des Freistellers durch Hintergrundentfernung, statt nur die Segmentierungsmaske zu verwenden. Wenn nichts übereinstimmt, wird das vollständige Eingabebild zurückgegeben.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
image_urloptional image
Typurl · image
Standardhttps://bria-datasets.s3.amazonaws.com/object-extraction/tools_construction_flatlay.jpg
Quellbild, bereitgestellt über eine öffentliche URL, rohe base64-codierte Bildbytes oder eine Base64-Daten-URI wie data:image/png;base64,... .
promptoptional
Typstring
Standardyellow hammer
Zu bearbeitendes Objekt, in natürlicher Sprache beschrieben, etwa 'the red car'.
autocropoptional
Typboolean
Standardfalse
Beschneidet die Ausgabe-Arbeitsfläche passend zum extrahierten Objekt.
remove_backgroundoptional
Typboolean
Standardfalse
Schalter zur Verfeinerung des Alpha-Kanals des Ausschnitts. Der Standardwert False überspringt das Matting für hervorstechende Objekte und übernimmt Alpha direkt aus der SAM-Segmentierung. Dadurch wird die Verarbeitung beschleunigt und Text, Logos oder Grafiken bleiben besser erhalten, die RMBG sonst möglicherweise übermäßig beschneiden würde. Setze den Wert auf True, um Alpha mithilfe der RMBG-Hintergrundentfernung zu verfeinern.
erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

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"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
image
object {url, content_type, file_name, file_size, width, height}Vollständiges Quellbild, wenn der Prompt kein passendes Objekt findet; andernfalls ein RGBA-Ergebnis mit dem extrahierten Objekt, das von Transparenz umgeben ist.
mask
object {url, content_type, file_name, file_size, width, height}Extraktionsmaske, deren Fallback bei fehlendem Treffer von der Eingabe abhängt: RGBA-Bilder liefern ihren Alphakanal, alle anderen Bilder erzeugen eine vollständig weiße Maske.

Weitere Modelle: Bildbearbeitung

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/bria/extract-object.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt