Lumaktaw sa nilalaman

Bria Product Shot

I-integrate

ID ng 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"

Kahilingang ito: $0.04 40 kredito ng API Patakbuhin ito sa page na ito

Kumuha ng API key
Bria AI · Larawan

Dito mapupunta ang iyong unang resulta

Bumuo ng kahilingan sa ibaba at patakbuhin ito gamit ang iyong API key. Kinokopya ang mga output sa aming storage, na pinananatili nang walang hanggan o 7 araw nang libre.

Bumuo ng kahilingan

Ang mga control ay binubuo mula sa schema ng modelo. Nagbabago ang code at presyo habang ina-adjust mo ang mga ito.

•kinakailangan image_url
Mag-drop ng file, o

URL ng larawan ng produkto para ilagay sa lifestyle scene; dapat jpeg, jpg, png, o webp ang larawan at hindi lalampas sa 12 MB. Kung ibinigay rin ang `image_file`, mauuna ang `image_url`.

default na 1

Bilang ng lifestyle product larawan bawat placement (`num_results`). Ang kabuuan ay bilang ng kinakailangang placement × `num_results` para sa `placement_type=manual_placement`, o `num_results` × 10 para sa `placement_type=automatic`.

advanced ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
default na
Mag-drop ng file, o

URL ng reference na larawan para bumuo ng bagong background o eksena ng product shot, na sinusuportahan ang jpeg, jpg, png, at webp. Magbigay ng eksaktong isa sa `scene_description` o `ref_image_url`; isinusulat ang walang lamang URL bilang "". Kapag ibinigay rin ang `ref_image_file`, mauuna ang `ref_image_url`.

placement_type default na manual_placement

Mode ng pagpoposisyon ng produkto, na may dalawang manual option: ginagamit ng 'manual_placement' ang mga paunang tinukoy na posisyong pinili sa pamamagitan ng 'manual_placement_selection', habang ina-adjust ng 'manual_padding' ang posisyon at laki ng larawan gamit ang pixel padding sa paligid ng produkto. Para mapanatili ang source position, piliin ang 'original'; para bumuo ng mga resultang nasa 10 inirerekomendang posisyon ng produkto, piliin ang 'automatic'.

Prompt na English lamang at walang special character, na naglalarawan sa eksena o background na gagawin para sa ibinigay na larawan ng produkto.

default na bottom_center

Mga preset na posisyong gagamitin kapag pinili ang placement_type=manual_placement. Pumili mula sa listahan; maaaring humiling ng maraming posisyon nang sabay.

default na [1000,1000]

Mga target dimension ng panghuling larawan ng produkto, na naaangkop lamang sa placement_type=automatic o placement_type=manual_placement. Para sa pinakamagandang resulta, maghangad ng humigit-kumulang 1,000,000 pixel sa kabuuan.

Pixel padding para sa `placement_type=manual_padding`, na ibinibigay bilang [left, right, top, bottom]. Para piliin ang mga value na ito, kumuha muna ng product cutout gamit ang product cutout API at suriin ang mga dimension nito, pagkatapos ay ipasa ang cutout na iyon sa API na ito kasama ang gustong padding. Maghangad ng humigit-kumulang 1,000,000 kabuuang pixel pagkatapos ng padding para sa pinakamainam na resulta.

POST /run/bria/product-shot?wait=20 presyo → $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"

Patakbuhin ang kahilingang ito

Nananatili ang iyong key sa browser na ito: ipinapadala lamang ito sa Doitong API at sine-save (localStorage) lamang kung pipiliin mo ang Tandaan. Kumuha ng API key

Tungkol sa Bria Product Shot

Inilalagay ang produkto mula sa `image_url` sa eksenang inilalarawan ng `scene_description` o ipinapakita sa `ref_image_url`, ngunit hindi pareho. Maaaring maging original, automatic, manual_placement o manual_padding ang `placement_type`, na may sampung posisyon para sa `manual_placement_selection` at `shot_size` na humigit-kumulang 1,000,000 pixel. Nasa 1 hanggang 4 ang saklaw ng `num_results`, at available ang `fast` mode.

Mga parameter

Ipadala ang canonical na pangalan o ang native na pangalan, hindi pareho. Mga canonical na pangalan

PangalanUri defaultPinapayagan Paglalarawan
image_urlkinakailangan image
Uriurl · image
URL ng larawan ng produkto para ilagay sa lifestyle scene; dapat jpeg, jpg, png, o webp ang larawan at hindi lalampas sa 12 MB. Kung ibinigay rin ang `image_file`, mauuna ang `image_url`.
scene_descriptionopsyonal
Uristring | null
Prompt na English lamang at walang special character, na naglalarawan sa eksena o background na gagawin para sa ibinigay na larawan ng produkto.
ref_image_urlopsyonal
Uriurl · image
default
URL ng reference na larawan para bumuo ng bagong background o eksena ng product shot, na sinusuportahan ang jpeg, jpg, png, at webp. Magbigay ng eksaktong isa sa `scene_description` o `ref_image_url`; isinusulat ang walang lamang URL bilang "". Kapag ibinigay rin ang `ref_image_file`, mauuna ang `ref_image_url`.
optimize_descriptionopsyonal
Uriboolean
defaulttrue
Kung naka-enable ang optimization ng scene description.
num_resultsopsyonal
Uriinteger
default1
1 – 4
Bilang ng lifestyle product larawan bawat placement (`num_results`). Ang kabuuan ay bilang ng kinakailangang placement × `num_results` para sa `placement_type=manual_placement`, o `num_results` × 10 para sa `placement_type=automatic`.
fastopsyonal
Uriboolean
defaulttrue
Kinokontrol kung pipiliin ang fast modelo.
placement_typeopsyonal
Urienum
defaultmanual_placement
originalautomaticmanual_placementmanual_padding
Mode ng pagpoposisyon ng produkto, na may dalawang manual option: ginagamit ng 'manual_placement' ang mga paunang tinukoy na posisyong pinili sa pamamagitan ng 'manual_placement_selection', habang ina-adjust ng 'manual_padding' ang posisyon at laki ng larawan gamit ang pixel padding sa paligid ng produkto. Para mapanatili ang source position, piliin ang 'original'; para bumuo ng mga resultang nasa 10 inirerekomendang posisyon ng produkto, piliin ang 'automatic'.
original_qualityopsyonal
Uriboolean
defaultfalse
Opsyon sa sizing ng output na ginagamit lamang sa `placement_type=original`: itina-scale ng false ang larawan sa 1 megapixel (1MP) nang hindi binabago ang aspect ratio nito, habang pinananatili ng true ang mga dimension ng input.
shot_sizeopsyonal
Uriinteger[]
default[1000,1000]
Mga target dimension ng panghuling larawan ng produkto, na naaangkop lamang sa placement_type=automatic o placement_type=manual_placement. Para sa pinakamagandang resulta, maghangad ng humigit-kumulang 1,000,000 pixel sa kabuuan.
manual_placement_selectionopsyonal
Urienum
defaultbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Mga preset na posisyong gagamitin kapag pinili ang placement_type=manual_placement. Pumili mula sa listahan; maaaring humiling ng maraming posisyon nang sabay.
padding_valuesopsyonal
Uriinteger[]
Pixel padding para sa `placement_type=manual_padding`, na ibinibigay bilang [left, right, top, bottom]. Para piliin ang mga value na ito, kumuha muna ng product cutout gamit ang product cutout API at suriin ang mga dimension nito, pagkatapos ay ipasa ang cutout na iyon sa API na ito kasama ang gustong padding. Maghangad ng humigit-kumulang 1,000,000 kabuuang pixel pagkatapos ng padding para sa pinakamainam na resulta.
kinakailangan Canonical na pangalan, tinatanggap din

Tumatanggap ang mga parameter ng file ng pampublikong https:// URL, data: URI na hanggang 10 MB, o file_url ng isang upload. Mga file

Output

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"
  }
}
Ikaw ang pumipili para sa iyong mga fileAng bawat outputs[].url ay kopya sa aming storage: pinananatili nang walang hanggan (sinisingil bawat GB-month) o 7 araw nang libre, ayon sa setting ng iyong account o ?storage=.
Parehong shape sa bawat modelotype, url, content_type, width, height at duration, para sa mga larawan, video at audio. Ang output ay sariling result object ng modelo.
Mga field ng output
images
array of object {url, content_type, file_name, file_size, width, height}Mga larawang ginawa ng modelo.

Higit pang modelo: Pag-edit ng Larawan

Para sa mga AI agent: nasa Markdown ang pahinang ito sa https://doitong.com/fil/developers/models/bria/product-shot.md. Lahat ng modelo at gabay: https://doitong.com/developers/llms.txt