Ir al contenido

Extract Object

Integrar

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

Esta solicitud: 0,02 $ 20 créditos de API Ejecutar en esta página

Obtener clave de API
Bria AI · Imagen

Tu primer resultado aparecerá aquí

Crea una solicitud a continuación y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, conservadas para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan al modificarlos.

Objeto sobre el que se actuará, descrito en lenguaje natural, como 'the red car'.

Avanzado image · autocrop · remove_background
image_url predeterminado https://bria-datasets...
Suelta un archivo o

Imagen de origen proporcionada mediante una URL pública, bytes de imagen sin procesar codificados en base64 o un URI de datos base64, como data:image/png;base64,... .

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

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y solo se guarda en localStorage si marcas Recordar. Obtener una clave de API

Acerca de Extract Object

Encuentra en la imagen de `image_url` el objeto descrito en `prompt` y lo devuelve sobre un fondo transparente junto con la máscara de segmentación. `autocrop` ajusta el lienzo al objeto. `remove_background` perfecciona el borde del recorte eliminando el fondo en lugar de usar solo la máscara de segmentación. Si no encuentra coincidencias, devuelve la imagen de entrada completa.

Parámetros

Envía el nombre canónico o el nombre nativo, pero no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
image_urlopcional image
Tipourl · image
Predeterminadohttps://bria-datasets.s3.amazonaws.com/object-extraction/tools_construction_flatlay.jpg
Imagen de origen proporcionada mediante una URL pública, bytes de imagen sin procesar codificados en base64 o un URI de datos base64, como data:image/png;base64,... .
promptopcional
Tipostring
Predeterminadoyellow hammer
Objeto sobre el que se actuará, descrito en lenguaje natural, como 'the red car'.
autocropopcional
Tipoboolean
Predeterminadofalse
Recorta el lienzo de salida para ajustarlo al objeto extraído.
remove_backgroundopcional
Tipoboolean
Predeterminadofalse
Interruptor de refinamiento del alfa del recorte. El valor predeterminado, False, omite el matteado de objetos destacados y toma el alfa directamente de la segmentación de SAM, lo que agiliza el procesamiento y ayuda a conservar texto, logotipos o gráficos que RMBG podría recortar en exceso. Establezca True para refinar el alfa mediante la eliminación de fondos de RMBG.
obligatorio Nombre canónico, también aceptado

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una subida. Archivos

Salida

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"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (con pago por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para vídeo y audio. output es el objeto de resultado propio del modelo.
Campos de salida
image
object {url, content_type, file_name, file_size, width, height}Imagen de origen completa si el prompt no encuentra ningún objeto coincidente; de lo contrario, un resultado RGBA con el objeto extraído rodeado de transparencia.
mask
object {url, content_type, file_name, file_size, width, height}Máscara de extracción cuyo resultado alternativo cuando no hay coincidencias depende de la entrada: las imágenes RGBA proporcionan su canal alfa, mientras que todas las demás imágenes generan una máscara completamente blanca.

Más modelos: Edición de imágenes

Para agentes de IA: esta página en Markdown está en https://doitong.com/es-ES/developers/models/bria/extract-object.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt