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 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.

•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 los 12 MB. Si también se proporciona `image_file`, `image_url` tiene prioridad.

predeterminado 1

Número de imágenes de producto de estilo de vida por colocación (`num_results`). El total es el número de colocaciones necesarias × `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 para una imagen 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' utiliza posiciones predefinidas seleccionadas mediante 'manual_placement_selection', mientras que 'manual_padding' ajusta la posición y el tamaño de la imagen mediante un 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 describe la escena o el fondo que se creará para la foto del producto proporcionada.

predeterminado bottom_center

Posiciones predefinidas que se utilizarán cuando se seleccione placement_type=manual_placement. Elige de la lista; se pueden solicitar varias posiciones a la vez.

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, intenta 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, obtén primero 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, intenta alcanzar unos 1.000.000 de píxeles en total después del relleno.

POST /run/bria/product-shot?wait=20 presupuesto → 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 solo se guarda en localStorage 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 de píxeles. `num_results` va de 1 a 4 y hay un modo `fast`.

Parámetros

Envía el nombre canónico o el nombre nativo, pero 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 los 12 MB. Si también se proporciona `image_file`, `image_url` tiene prioridad.
scene_descriptionopcional
Tipostring | null
Prompt exclusivamente en inglés y sin caracteres especiales que describe 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 para una imagen 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á activada.
num_resultsopcional
Tipointeger
Predeterminado1
1 – 4
Número de imágenes de producto de estilo de vida por colocación (`num_results`). El total es el número de colocaciones necesarias × `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' utiliza posiciones predefinidas seleccionadas mediante 'manual_placement_selection', mientras que 'manual_padding' ajusta la posición y el tamaño de la imagen mediante un 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 dimensionamiento 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, intenta 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 predefinidas que se utilizarán cuando se seleccione placement_type=manual_placement. Elige de la lista; se pueden solicitar varias posiciones a la vez.
padding_valuesopcional
Tipointeger[]
Relleno en píxeles para `placement_type=manual_padding`, proporcionado como [left, right, top, bottom]. Para elegir estos valores, obtén primero 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, intenta alcanzar unos 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 subida. 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: 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
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á en https://doitong.com/es-ES/developers/models/bria/product-shot.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt