Aqbeż għall-kontenut

Bria Product Shot

Integra

Id tal-mudell 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"

Din it-talba: $0.04 40 krediti tal-API Ħaddmu f’din il-paġna

Ikseb ċavetta API
Bria AI · Immaġni

L-ewwel riżultat tiegħek jidher hawn

Ibni talba hawn taħt u ħaddimha biċ-ċavetta API tiegħek. L-outputs jiġu kkupjati fil-ħażna tagħna, miżmuma għal dejjem jew 7 ijiem b’xejn.

Ibni talba

Il-kontrolli jiġu ġġenerati mill-iskema tal-mudell. Il-kodiċi u l-prezz jaġġornaw hekk kif tibdilhom.

•meħtieġ image_url
Waqqa’ fajl, jew

URL tar-ritratt tal-prodott biex jitqiegħed f’xena tal-ħajja ta’ kuljum; l-immaġni trid tkun jpeg, jpg, png, webp u mhux akbar minn 12 MB. Jekk jingħata wkoll `image_file`, `image_url` jieħu prijorità.

prestabbilit 1

Għadd ta’ immaġnijiet tal-prodott f’xena tal-ħajja ta’ kuljum għal kull pożizzjonament (`num_results`). It-total huwa l-għadd ta’ pożizzjonamenti meħtieġa × `num_results` għal `placement_type=manual_placement`, jew `num_results` × 10 għal `placement_type=automatic`.

Avvanzat ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
prestabbilit
Waqqa’ fajl, jew

URL tal-immaġni ta’ referenza għall-ġenerazzjoni ta’ sfond jew xena ġdida għal ritratt tal-prodott, b’appoġġ għal jpeg, jpg, png, u webp. Ipprovdi eżattament wieħed minn `scene_description` jew `ref_image_url`; URL vojt jinkiteb bħala "". Meta jingħata wkoll `ref_image_file`, `ref_image_url` jieħu prijorità.

placement_type prestabbilit manual_placement

Modalità ta’ pożizzjonament tal-prodott, b’żewġ għażliet manwali: 'manual_placement' tuża pożizzjonijiet predefiniti magħżula permezz ta’ 'manual_placement_selection', filwaqt li 'manual_padding' taġġusta l-pożizzjoni u d-daqs tal-immaġni permezz ta’ marġni f’pixels madwar il-prodott. Biex iżżomm il-pożizzjoni oriġinali, agħżel 'original'; biex tiġġenera riżultati f’10 pożizzjonijiet rakkomandati tal-prodott, agħżel 'automatic'.

Prompt bl-Ingliż biss mingħajr karattri speċjali, li jiddeskrivi x-xena jew l-isfond li għandhom jinħolqu għar-ritratt tal-prodott ipprovdut.

prestabbilit bottom_center

Pożizzjonijiet predefiniti li jintużaw meta jintgħażel placement_type=manual_placement. Agħżel mil-lista; jistgħu jintalbu diversi pożizzjonijiet flimkien.

prestabbilit [1000,1000]

Dimensjonijiet mixtieqa għall-immaġni finali tal-prodott, applikabbli biss ma’ placement_type=automatic jew placement_type=manual_placement. Għall-aħjar riżultati, immira għal madwar 1,000,000 pixels b’kollox.

Marġni f’pixels għal `placement_type=manual_padding`, mogħti bħala [left, right, top, bottom]. Biex tagħżel dawn il-valuri, l-ewwel ikseb qtugħ tal-prodott bl-API tal-qtugħ tal-prodott u spezzjona d-dimensjonijiet tiegħu, imbagħad għaddi dak il-qtugħ lil din l-API bil-marġni mixtieq. Immira għal madwar 1,000,000 pixels b’kollox wara ż-żieda tal-marġni għall-aħjar riżultati.

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

Ħaddem din it-talba

Iċ-ċavetta tiegħek tibqa’ f’dan il-browser: tintbagħat biss lid-Doitong API u tiġi ssejvjata (localStorage) biss jekk timmarka Ftakar. Ikseb ċavetta API

Dwar Bria Product Shot

Iqiegħed il-prodott minn `image_url` f’xena deskritta minn `scene_description` jew murija f’`ref_image_url`, iżda mhux it-tnejn. `placement_type` jista’ jkun original, automatic, manual_placement jew manual_padding, b’għaxar pożizzjonijiet `manual_placement_selection` u `shot_size` ta’ madwar 1,000,000 pixel. `num_results` ivarja minn 1 sa 4, u hemm modalità `fast` disponibbli.

Parametri

Ibgħat jew l-isem kanoniku jew l-isem nattiv, mhux it-tnejn. Ismijiet kanoniċi

IsemTip PrestabbilitPermess Deskrizzjoni
image_urlmeħtieġ image
Tipurl · image
URL tar-ritratt tal-prodott biex jitqiegħed f’xena tal-ħajja ta’ kuljum; l-immaġni trid tkun jpeg, jpg, png, webp u mhux akbar minn 12 MB. Jekk jingħata wkoll `image_file`, `image_url` jieħu prijorità.
scene_descriptionmhux obbligatorju
Tipstring | null
Prompt bl-Ingliż biss mingħajr karattri speċjali, li jiddeskrivi x-xena jew l-isfond li għandhom jinħolqu għar-ritratt tal-prodott ipprovdut.
ref_image_urlmhux obbligatorju
Tipurl · image
Prestabbilit
URL tal-immaġni ta’ referenza għall-ġenerazzjoni ta’ sfond jew xena ġdida għal ritratt tal-prodott, b’appoġġ għal jpeg, jpg, png, u webp. Ipprovdi eżattament wieħed minn `scene_description` jew `ref_image_url`; URL vojt jinkiteb bħala "". Meta jingħata wkoll `ref_image_file`, `ref_image_url` jieħu prijorità.
optimize_descriptionmhux obbligatorju
Tipboolean
Prestabbilittrue
Jekk l-ottimizzazzjoni tad-deskrizzjoni tax-xena hijiex attivata.
num_resultsmhux obbligatorju
Tipinteger
Prestabbilit1
1 – 4
Għadd ta’ immaġnijiet tal-prodott f’xena tal-ħajja ta’ kuljum għal kull pożizzjonament (`num_results`). It-total huwa l-għadd ta’ pożizzjonamenti meħtieġa × `num_results` għal `placement_type=manual_placement`, jew `num_results` × 10 għal `placement_type=automatic`.
fastmhux obbligatorju
Tipboolean
Prestabbilittrue
Jikkontrolla jekk jintgħażilx il-mudell veloċi.
placement_typemhux obbligatorju
Tipenum
Prestabbilitmanual_placement
originalautomaticmanual_placementmanual_padding
Modalità ta’ pożizzjonament tal-prodott, b’żewġ għażliet manwali: 'manual_placement' tuża pożizzjonijiet predefiniti magħżula permezz ta’ 'manual_placement_selection', filwaqt li 'manual_padding' taġġusta l-pożizzjoni u d-daqs tal-immaġni permezz ta’ marġni f’pixels madwar il-prodott. Biex iżżomm il-pożizzjoni oriġinali, agħżel 'original'; biex tiġġenera riżultati f’10 pożizzjonijiet rakkomandati tal-prodott, agħżel 'automatic'.
original_qualitymhux obbligatorju
Tipboolean
Prestabbilitfalse
Għażla tad-daqs tal-output użata biss ma’ `placement_type=original`: false tiskala l-immaġni għal 1 megapixel (1MP) mingħajr ma tbiddel il-proporzjon tagħha, filwaqt li true żżomm id-dimensjonijiet tal-input.
shot_sizemhux obbligatorju
Tipinteger[]
Prestabbilit[1000,1000]
Dimensjonijiet mixtieqa għall-immaġni finali tal-prodott, applikabbli biss ma’ placement_type=automatic jew placement_type=manual_placement. Għall-aħjar riżultati, immira għal madwar 1,000,000 pixels b’kollox.
manual_placement_selectionmhux obbligatorju
Tipenum
Prestabbilitbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Pożizzjonijiet predefiniti li jintużaw meta jintgħażel placement_type=manual_placement. Agħżel mil-lista; jistgħu jintalbu diversi pożizzjonijiet flimkien.
padding_valuesmhux obbligatorju
Tipinteger[]
Marġni f’pixels għal `placement_type=manual_padding`, mogħti bħala [left, right, top, bottom]. Biex tagħżel dawn il-valuri, l-ewwel ikseb qtugħ tal-prodott bl-API tal-qtugħ tal-prodott u spezzjona d-dimensjonijiet tiegħu, imbagħad għaddi dak il-qtugħ lil din l-API bil-marġni mixtieq. Immira għal madwar 1,000,000 pixels b’kollox wara ż-żieda tal-marġni għall-aħjar riżultati.
meħtieġ Isem kanoniku, aċċettat ukoll

Il-parametri tal-fajls jaċċettaw URL pubbliku https://, URI data: sa 10 MB, jew file_url ta’ upload. Fajls

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"
  }
}
Il-fajls tiegħek, l-għażla tiegħekKull outputs[].url huwa kopja fil-ħażna tagħna: miżmuma għal dejjem (imħallsa għal kull GB-xahar) jew 7 ijiem b’xejn, skont l-issettjar tal-kont tiegħek jew ?storage=.
L-istess struttura fuq kull mudelltype, url, content_type, width, height u duration, kemm għall-immaġnijiet kif ukoll għall-vidjo u l-awdjo. output huwa l-oġġett tar-riżultat tal-mudell innifsu.
Oqsma tal-output
images
array of object {url, content_type, file_name, file_size, width, height}Immaġnijiet prodotti mill-mudell.

Aktar mudelli: Editjar tal-immaġini

Għall-aġenti tal-AI: din il-paġna bħala Markdown tinsab fuq https://doitong.com/mt/developers/models/bria/product-shot.md. Il-mudelli u l-gwidi kollha: https://doitong.com/developers/llms.txt