Ir al contenido

Bria Product Shot

Integrar

ID del modelo bria/product-shot
# 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/product-shot?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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.04 40 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.

•obligatorio image_url
Suelta un archivo o

URL de la foto del producto para colocarla en una escena de estilo de vida; la imagen debe ser jpeg, jpg, png o webp y no superar 12 MB. Si también se proporciona un `image_file`, `image_url` tiene prioridad.

predeterminado 1

Cantidad de imágenes de producto de estilo de vida por colocación (`num_results`). El total es el número de colocaciones requeridas × `num_results` para `placement_type=manual_placement`, o `num_results` × 10 para `placement_type=automatic`.

Avanzado ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
predeterminado
Suelta un archivo o

URL de la imagen de referencia para generar un nuevo fondo o escena de una toma del producto; se admiten jpeg, jpg, png y webp. Proporciona exactamente uno de `scene_description` o `ref_image_url`; una URL vacía se escribe como "". Si también se proporciona `ref_image_file`, `ref_image_url` tiene prioridad.

placement_type predeterminado manual_placement

Modo de posicionamiento del producto, con dos opciones manuales: 'manual_placement' usa posiciones predefinidas seleccionadas mediante 'manual_placement_selection', mientras que 'manual_padding' ajusta la posición y el tamaño de la imagen mediante relleno en píxeles alrededor del producto. Para conservar la posición de origen, selecciona 'original'; para generar resultados en 10 posiciones recomendadas del producto, selecciona 'automatic'.

Prompt exclusivamente en inglés y sin caracteres especiales que describa la escena o el fondo que se creará para la foto del producto proporcionada.

predeterminado bottom_center

Posiciones preestablecidas que se usarán cuando se seleccione placement_type=manual_placement. Elige de la lista; se pueden solicitar varias posiciones juntas.

predeterminado [1000,1000]

Dimensiones objetivo de la imagen final del producto, aplicables solo con placement_type=automatic o placement_type=manual_placement. Para obtener mejores resultados, procura alcanzar aproximadamente 1,000,000 de píxeles en total.

Relleno en píxeles para `placement_type=manual_padding`, proporcionado como [left, right, top, bottom]. Para elegir estos valores, primero obtén un recorte del producto mediante la API de recorte de productos e inspecciona sus dimensiones; después, pasa ese recorte a esta API con el relleno deseado. Para obtener resultados óptimos, procura alcanzar alrededor de 1,000,000 de píxeles en total después del relleno.

POST /run/bria/product-shot?wait=20 cotización → $0.04
# 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/product-shot?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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 Bria Product Shot

Coloca el producto de `image_url` en una escena descrita por `scene_description` o mostrada en `ref_image_url`, pero no ambas. `placement_type` puede ser original, automatic, manual_placement o manual_padding, con diez posiciones de `manual_placement_selection` y un `shot_size` de aproximadamente 1,000,000 píxeles. `num_results` va de 1 a 4 y hay un modo `fast` disponible.

Parámetros

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

NombreTipo PredeterminadoPermitido Descripción
image_urlobligatorio image
Tipourl · image
URL de la foto del producto para colocarla en una escena de estilo de vida; la imagen debe ser jpeg, jpg, png o webp y no superar 12 MB. Si también se proporciona un `image_file`, `image_url` tiene prioridad.
scene_descriptionopcional
Tipostring | null
Prompt exclusivamente en inglés y sin caracteres especiales que describa la escena o el fondo que se creará para la foto del producto proporcionada.
ref_image_urlopcional
Tipourl · image
Predeterminado
URL de la imagen de referencia para generar un nuevo fondo o escena de una toma del producto; se admiten jpeg, jpg, png y webp. Proporciona exactamente uno de `scene_description` o `ref_image_url`; una URL vacía se escribe como "". Si también se proporciona `ref_image_file`, `ref_image_url` tiene prioridad.
optimize_descriptionopcional
Tipoboolean
Predeterminadotrue
Indica si la optimización de la descripción de la escena está habilitada.
num_resultsopcional
Tipointeger
Predeterminado1
1 – 4
Cantidad de imágenes de producto de estilo de vida por colocación (`num_results`). El total es el número de colocaciones requeridas × `num_results` para `placement_type=manual_placement`, o `num_results` × 10 para `placement_type=automatic`.
fastopcional
Tipoboolean
Predeterminadotrue
Controla si se selecciona el modelo rápido.
placement_typeopcional
Tipoenum
Predeterminadomanual_placement
originalautomaticmanual_placementmanual_padding
Modo de posicionamiento del producto, con dos opciones manuales: 'manual_placement' usa posiciones predefinidas seleccionadas mediante 'manual_placement_selection', mientras que 'manual_padding' ajusta la posición y el tamaño de la imagen mediante relleno en píxeles alrededor del producto. Para conservar la posición de origen, selecciona 'original'; para generar resultados en 10 posiciones recomendadas del producto, selecciona 'automatic'.
original_qualityopcional
Tipoboolean
Predeterminadofalse
Opción de tamaño de salida utilizada solo con `placement_type=original`: false escala la imagen a 1 megapíxel (1MP) sin alterar su relación de aspecto, mientras que true conserva las dimensiones de entrada.
shot_sizeopcional
Tipointeger[]
Predeterminado[1000,1000]
Dimensiones objetivo de la imagen final del producto, aplicables solo con placement_type=automatic o placement_type=manual_placement. Para obtener mejores resultados, procura alcanzar aproximadamente 1,000,000 de píxeles en total.
manual_placement_selectionopcional
Tipoenum
Predeterminadobottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Posiciones preestablecidas que se usarán cuando se seleccione placement_type=manual_placement. Elige de la lista; se pueden solicitar varias posiciones juntas.
padding_valuesopcional
Tipointeger[]
Relleno en píxeles para `placement_type=manual_padding`, proporcionado como [left, right, top, bottom]. Para elegir estos valores, primero obtén un recorte del producto mediante la API de recorte de productos e inspecciona sus dimensiones; después, pasa ese recorte a esta API con el relleno deseado. Para obtener resultados óptimos, procura alcanzar alrededor de 1,000,000 de píxeles en total después del relleno.
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/product-shot",
  "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": 40,
    "usd": "0.04",
    "charged": 40,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "images": [
      {
        "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
images
array of object {url, content_type, file_name, file_size, width, height}Imágenes producidas por el modelo.

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/product-shot.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt