Pāriet uz saturu

Bria Product Shot

Integrēt

Modeļa id 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"

Šis pieprasījums: 0,04 $ 40 API kredītu Izpildīt šajā lapā

Iegūt API atslēgu
Bria AI · Attēls

Šeit būs jūsu pirmais rezultāts

Izveidojiet pieprasījumu tālāk un izpildiet to ar savu API atslēgu. Izvades tiek kopētas mūsu krātuvē un glabātas mūžīgi vai 7 dienas bez maksas.

Izveidot pieprasījumu

Vadīklas tiek ģenerētas no modeļa shēmas. Kods un cena tiek atjaunināti, kad tos maināt.

•obligāts image_url
Nometiet failu vai

Produkta fotoattēla URL izvietošanai dzīvesstila ainā; attēlam jābūt jpeg, jpg, png vai webp formātā, un tā izmērs nedrīkst pārsniegt 12 MB. Ja iesniegts arī `image_file`, prioritāte ir `image_url`.

noklusējums 1

Dzīvesstila produkta attēlu skaits katrai izvietošanai (`num_results`). Kopējais skaits ir nepieciešamo izvietojumu skaits × `num_results` priekš `placement_type=manual_placement` vai `num_results` × 10 priekš `placement_type=automatic`.

Papildu ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
noklusējums
Nometiet failu vai

Atsauces attēla URL jauna produkta attēla fona vai ainas ģenerēšanai; tiek atbalstīti jpeg, jpg, png un webp. Norādiet tieši vienu no `scene_description` vai `ref_image_url`; tukšs URL tiek rakstīts kā "". Ja iesniegts arī `ref_image_file`, prioritāte ir `ref_image_url`.

placement_type noklusējums manual_placement

Produkta pozicionēšanas režīms ar divām manuālām iespējām: 'manual_placement' izmanto iepriekš definētas pozīcijas, kas atlasītas ar 'manual_placement_selection', bet 'manual_padding' pielāgo attēla pozīciju un izmēru, izmantojot pikseļu atkāpes ap produktu. Lai saglabātu avota pozīciju, atlasiet 'original'; lai ģenerētu rezultātus 10 ieteiktajās produkta pozīcijās, atlasiet 'automatic'.

Tikai angļu valodā rakstīta uzvedne bez speciālajām rakstzīmēm, kas apraksta izveidojamo ainu vai fonu iesniegtajam produkta fotoattēlam.

noklusējums bottom_center

Iepriekš iestatītās pozīcijas, kas jāizmanto, ja atlasīts placement_type=manual_placement. Izvēlieties no saraksta; kopā var pieprasīt vairākas pozīcijas.

noklusējums [1000,1000]

Gatavā produkta attēla mērķa izmēri, kas piemērojami tikai ar placement_type=automatic vai placement_type=manual_placement. Labākam rezultātam mērķējiet uz aptuveni 1,000,000 pikseļiem kopumā.

Pikseļu atkāpes priekš `placement_type=manual_padding`, kas iesniegtas kā [left, right, top, bottom]. Lai izvēlētos šīs vērtības, vispirms iegūstiet produkta izgriezumu, izmantojot produkta izgriezumu API, un pārbaudiet tā izmērus, pēc tam nododiet šo izgriezumu šim API ar vēlamajām atkāpēm. Optimālam rezultātam pēc atkāpju pievienošanas mērķējiet uz aptuveni 1,000,000 pikseļiem kopumā.

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

Palaist šo pieprasījumu

Jūsu atslēga paliek šajā pārlūkprogrammā: tā tiek nosūtīta tikai uz Doitong API un saglabāta (localStorage) tikai tad, ja atzīmējat Atcerēties. Iegūt API atslēgu

Par Bria Product Shot

Ievieto produktu no `image_url` ainā, kas aprakstīta ar `scene_description` vai parādīta `ref_image_url`, bet ne abiem. `placement_type` var būt original, automatic, manual_placement vai manual_padding, ar desmit `manual_placement_selection` pozīcijām un aptuveni 1,000,000 pikseļu `shot_size`. `num_results` ir no 1 līdz 4, un pieejams `fast` režīms.

Parametri

Nosūti vai nu kanonisko nosaukumu, vai vietējo nosaukumu, bet ne abus. Kan啤niskie nosaukumi

NosaukumsTips NoklusējumsAtļauts Apraksts
image_urlobligāts image
Tipsurl · image
Produkta fotoattēla URL izvietošanai dzīvesstila ainā; attēlam jābūt jpeg, jpg, png vai webp formātā, un tā izmērs nedrīkst pārsniegt 12 MB. Ja iesniegts arī `image_file`, prioritāte ir `image_url`.
scene_descriptionneobligāts
Tipsstring | null
Tikai angļu valodā rakstīta uzvedne bez speciālajām rakstzīmēm, kas apraksta izveidojamo ainu vai fonu iesniegtajam produkta fotoattēlam.
ref_image_urlneobligāts
Tipsurl · image
Noklusējums
Atsauces attēla URL jauna produkta attēla fona vai ainas ģenerēšanai; tiek atbalstīti jpeg, jpg, png un webp. Norādiet tieši vienu no `scene_description` vai `ref_image_url`; tukšs URL tiek rakstīts kā "". Ja iesniegts arī `ref_image_file`, prioritāte ir `ref_image_url`.
optimize_descriptionneobligāts
Tipsboolean
Noklusējumstrue
Vai ainas apraksta optimizācija ir iespējota.
num_resultsneobligāts
Tipsinteger
Noklusējums1
1 – 4
Dzīvesstila produkta attēlu skaits katrai izvietošanai (`num_results`). Kopējais skaits ir nepieciešamo izvietojumu skaits × `num_results` priekš `placement_type=manual_placement` vai `num_results` × 10 priekš `placement_type=automatic`.
fastneobligāts
Tipsboolean
Noklusējumstrue
Nosaka, vai ir atlasīts ātrais modelis.
placement_typeneobligāts
Tipsenum
Noklusējumsmanual_placement
originalautomaticmanual_placementmanual_padding
Produkta pozicionēšanas režīms ar divām manuālām iespējām: 'manual_placement' izmanto iepriekš definētas pozīcijas, kas atlasītas ar 'manual_placement_selection', bet 'manual_padding' pielāgo attēla pozīciju un izmēru, izmantojot pikseļu atkāpes ap produktu. Lai saglabātu avota pozīciju, atlasiet 'original'; lai ģenerētu rezultātus 10 ieteiktajās produkta pozīcijās, atlasiet 'automatic'.
original_qualityneobligāts
Tipsboolean
Noklusējumsfalse
Izvades izmēra opcija, ko izmanto tikai ar `placement_type=original`: false mērogo attēlu līdz 1 megapikselim (1MP), nemainot tā malu attiecību, bet true saglabā ievades izmērus.
shot_sizeneobligāts
Tipsinteger[]
Noklusējums[1000,1000]
Gatavā produkta attēla mērķa izmēri, kas piemērojami tikai ar placement_type=automatic vai placement_type=manual_placement. Labākam rezultātam mērķējiet uz aptuveni 1,000,000 pikseļiem kopumā.
manual_placement_selectionneobligāts
Tipsenum
Noklusējumsbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Iepriekš iestatītās pozīcijas, kas jāizmanto, ja atlasīts placement_type=manual_placement. Izvēlieties no saraksta; kopā var pieprasīt vairākas pozīcijas.
padding_valuesneobligāts
Tipsinteger[]
Pikseļu atkāpes priekš `placement_type=manual_padding`, kas iesniegtas kā [left, right, top, bottom]. Lai izvēlētos šīs vērtības, vispirms iegūstiet produkta izgriezumu, izmantojot produkta izgriezumu API, un pārbaudiet tā izmērus, pēc tam nododiet šo izgriezumu šim API ar vēlamajām atkāpēm. Optimālam rezultātam pēc atkāpju pievienošanas mērķējiet uz aptuveni 1,000,000 pikseļiem kopumā.
obligāts Kan啤niskais nosaukums, arī pieņemts

Failu parametriem nepieciešams publisks https:// URL, data: URI līdz 10 MB vai augšupielādes file_url. Faili

Izvade

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"
  }
}
Jūsu faili, jūsu izvēleKatrs outputs[].url ir kopija mūsu krātuvē: tiek glabāta mūžīgi (maksa par GB mēnesī) vai 7 dienas bez maksas — atbilstoši konta iestatījumam vai ?storage=.
Vienāda struktūra katram modelimtype, url, content_type, width, height un duration gan attēliem, gan video un audio. output ir paša modeļa rezultāta objekts.
Izvades lauki
images
array of object {url, content_type, file_name, file_size, width, height}Modeļa ģenerētie attēli.

Vairāk modeļu: Attēlu rediģēšana

AI aģentiem: šī lapa Markdown formātā ir pieejama https://doitong.com/lv/developers/models/bria/product-shot.md. Visi modeļi un ceļveži: https://doitong.com/developers/llms.txt