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 abajo y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, donde se conservan 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 conforme los cambias.

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 cotización → $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 se guarda en localStorage únicamente si marcas Recordar. Obtener una clave de API

Acerca de Extract Object

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

Parámetros

Envía el nombre canónico o el nombre nativo, 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 alfa del recorte. El valor predeterminado, False, omite el mateado de objetos destacados y toma el alfa directamente de la segmentación de SAM, lo que acelera el procesamiento y ayuda a conservar texto, logotipos o gráficos que RMBG podría recortar demasiado. Establece True para refinar el alfa mediante la eliminación de fondo 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 carga. 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: se conserva para siempre (con cobro 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 video 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 producen una máscara completamente blanca.

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

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