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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Esta solicitud: 0,04 $ 40 créditos de API · ≈ 4,19 ₽ 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, 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, webp y no superar los 12 MB. Si también se proporciona `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' utiliza 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 del origen, selecciona 'original'; para generar resultados en 10 posiciones recomendadas del producto, selecciona 'automatic'.

Prompt solo 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 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, apunta aproximadamente a 1,000,000 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. Apunta a unos 1,000,000 píxeles totales después del relleno para obtener resultados óptimos.

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.ru/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.ru/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 (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, webp y no superar los 12 MB. Si también se proporciona `image_file`, `image_url` tiene prioridad.
scene_descriptionopcional
Tipostring | null
Prompt solo 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' utiliza 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 del 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, apunta aproximadamente a 1,000,000 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. Apunta a unos 1,000,000 píxeles totales después del relleno para obtener resultados óptimos.
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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (se cobra 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/developers/models/bria/product-shot.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt