Leum chun t-susbaint

Bria Product Shot

Amalaich

ID a’ mhodail 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"

An t-iarrtas seo: $0.04 40 creideasan API Ruith e air an duilleig seo

Faigh iuchair API
Bria AI · Ìomhaigh

Thèid a’ chiad toradh agad an-seo

Tog iarrtas gu h-ìosal agus ruith e leis an iuchair API agad. Tha na h-às-churan air an lethbhreacadh dhan stòradh againn, air an cumail gu bràth no 7 latha an-asgaidh.

Tog iarrtas

Tha na smachdan air an cruthachadh bho sgeama a’ mhodail. Bidh an còd agus a’ phrìs ag ùrachadh fhad ’s a dh’atharraicheas tu iad.

•riatanach image_url
Leig às faidhle, no

URL dealbh toraidh airson a shuidheachadh ann an sealladh dòigh-beatha; feumaidh an ìomhaigh a bhith jpeg, jpg, png, webp agus gun a bhith nas motha na 12 MB. Ma thèid `image_file` a thoirt seachad cuideachd, bidh `image_url` a’ faighinn prìomhachas.

bun-roghainn 1

Cunntas ìomhaighean toraidh dòigh-beatha gach suidheachadh (`num_results`). Is e an t-iomlan an àireamh de shuidheachaidhean a tha riatanach × `num_results` airson `placement_type=manual_placement`, no `num_results` × 10 airson `placement_type=automatic`.

Adhartach ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
bun-roghainn
Leig às faidhle, no

URL ìomhaigh iomraidh airson cùl-raon no sealladh ùr dealbh toraidh a ghineadh, le jpeg, jpg, png, agus webp a’ faighinn taic. Thoir seachad dìreach aon de `scene_description` no `ref_image_url`; thèid URL falamh a sgrìobhadh mar "". Nuair a thèid `ref_image_file` a thoirt seachad cuideachd, bidh `ref_image_url` a’ faighinn prìomhachas.

placement_type bun-roghainn manual_placement

Modh suidheachaidh an toraidh, le dà roghainn làimhe: bidh 'manual_placement' a’ cleachdadh shuidheachaidhean ro-mhìnichte a chaidh a thaghadh tro 'manual_placement_selection', agus bidh 'manual_padding' ag atharrachadh suidheachadh is meud na h-ìomhaigh tro phadding piogsail timcheall an toraidh. Gus suidheachadh na tùsail a ghleidheadh, tagh 'original'; gus toraidhean a ghineadh thar 10 suidheachaidhean toraidh molaichte, tagh 'automatic'.

Prompt ann am Beurla a-mhàin gun charactaran sònraichte, a’ mìneachadh an t-seallaidh no a’ chùil-raoin a thèid a chruthachadh airson an dealbh toraidh a chaidh a thoirt seachad.

bun-roghainn bottom_center

Suidheachaidhean ro-shuidhichte ri chleachdadh nuair a thèid placement_type=manual_placement a thaghadh. Tagh on liosta; faodar iomadh suidheachadh iarraidh còmhla.

bun-roghainn [1000,1000]

Meudan targaid airson ìomhaigh an toraidh dheireannaich, iomchaidh a-mhàin le placement_type=automatic no placement_type=manual_placement. Airson nan toraidhean as fheàrr, feuch ri mu 1,000,000 piogsail gu lèir.

Padding piogsail airson `placement_type=manual_padding`, air a thoirt seachad mar [left, right, top, bottom]. Gus na luachan seo a thaghadh, faigh gearradh toraidh an toiseach a’ cleachdadh API gearraidh toraidh agus sgrùd na meudan aige, an uairsin cuir an gearradh sin chun API seo leis a’ phadding a tha thu ag iarraidh. Feuch ri mu 1,000,000 piogsail gu lèir às dèidh padding airson nan toraidhean as fheàrr.

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

Ruith an t-iarrtas seo

Fuirichidh an iuchair agad sa bhrobhsair seo: thèid a cur chun Doitong API a-mhàin agus a sàbhaladh (localStorage) a-mhàin ma chuireas tu comharra ri Cuimhnich. Faigh iuchair API

Mu Bria Product Shot

Cuiridh e an toradh bho `image_url` ann an sealladh air a mhìneachadh le `scene_description` no air a shealltainn ann an `ref_image_url`, ach chan ann leis an dà chuid. Faodaidh `placement_type` a bhith original, automatic, manual_placement no manual_padding, le deich suidheachaidhean `manual_placement_selection` agus `shot_size` de mu 1,000,000 piogsail. Tha `num_results` eadar 1 agus 4, agus tha modh `fast` ri fhaighinn.

Paramadairean

Cuir an t-ainm canonical no an t-ainm dùthchasach, chan e an dà chuid. Ainmean canonical

AinmSeòrsa Bun-roghainnCeadaichte Tuairisgeul
image_urlriatanach image
Seòrsaurl · image
URL dealbh toraidh airson a shuidheachadh ann an sealladh dòigh-beatha; feumaidh an ìomhaigh a bhith jpeg, jpg, png, webp agus gun a bhith nas motha na 12 MB. Ma thèid `image_file` a thoirt seachad cuideachd, bidh `image_url` a’ faighinn prìomhachas.
scene_descriptionroghainneil
Seòrsastring | null
Prompt ann am Beurla a-mhàin gun charactaran sònraichte, a’ mìneachadh an t-seallaidh no a’ chùil-raoin a thèid a chruthachadh airson an dealbh toraidh a chaidh a thoirt seachad.
ref_image_urlroghainneil
Seòrsaurl · image
Bun-roghainn
URL ìomhaigh iomraidh airson cùl-raon no sealladh ùr dealbh toraidh a ghineadh, le jpeg, jpg, png, agus webp a’ faighinn taic. Thoir seachad dìreach aon de `scene_description` no `ref_image_url`; thèid URL falamh a sgrìobhadh mar "". Nuair a thèid `ref_image_file` a thoirt seachad cuideachd, bidh `ref_image_url` a’ faighinn prìomhachas.
optimize_descriptionroghainneil
Seòrsaboolean
Bun-roghainntrue
Co-dhiù a bheil optimization tuairisgeul an t-seallaidh an comas.
num_resultsroghainneil
Seòrsainteger
Bun-roghainn1
1 – 4
Cunntas ìomhaighean toraidh dòigh-beatha gach suidheachadh (`num_results`). Is e an t-iomlan an àireamh de shuidheachaidhean a tha riatanach × `num_results` airson `placement_type=manual_placement`, no `num_results` × 10 airson `placement_type=automatic`.
fastroghainneil
Seòrsaboolean
Bun-roghainntrue
Smachd air a bheil am modail luath air a thaghadh.
placement_typeroghainneil
Seòrsaenum
Bun-roghainnmanual_placement
originalautomaticmanual_placementmanual_padding
Modh suidheachaidh an toraidh, le dà roghainn làimhe: bidh 'manual_placement' a’ cleachdadh shuidheachaidhean ro-mhìnichte a chaidh a thaghadh tro 'manual_placement_selection', agus bidh 'manual_padding' ag atharrachadh suidheachadh is meud na h-ìomhaigh tro phadding piogsail timcheall an toraidh. Gus suidheachadh na tùsail a ghleidheadh, tagh 'original'; gus toraidhean a ghineadh thar 10 suidheachaidhean toraidh molaichte, tagh 'automatic'.
original_qualityroghainneil
Seòrsaboolean
Bun-roghainnfalse
Roghainn meudachaidh às-chuir a thèid a chleachdadh le `placement_type=original` a-mhàin: bidh false a’ sgèileadh na h-ìomhaigh gu 1 megapixel (1MP) gun a co-mheas taobh atharrachadh, agus bidh true a’ cumail meudan an in-chuir.
shot_sizeroghainneil
Seòrsainteger[]
Bun-roghainn[1000,1000]
Meudan targaid airson ìomhaigh an toraidh dheireannaich, iomchaidh a-mhàin le placement_type=automatic no placement_type=manual_placement. Airson nan toraidhean as fheàrr, feuch ri mu 1,000,000 piogsail gu lèir.
manual_placement_selectionroghainneil
Seòrsaenum
Bun-roghainnbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Suidheachaidhean ro-shuidhichte ri chleachdadh nuair a thèid placement_type=manual_placement a thaghadh. Tagh on liosta; faodar iomadh suidheachadh iarraidh còmhla.
padding_valuesroghainneil
Seòrsainteger[]
Padding piogsail airson `placement_type=manual_padding`, air a thoirt seachad mar [left, right, top, bottom]. Gus na luachan seo a thaghadh, faigh gearradh toraidh an toiseach a’ cleachdadh API gearraidh toraidh agus sgrùd na meudan aige, an uairsin cuir an gearradh sin chun API seo leis a’ phadding a tha thu ag iarraidh. Feuch ri mu 1,000,000 piogsail gu lèir às dèidh padding airson nan toraidhean as fheàrr.
riatanach Ainm canonical, gabhar ris cuideachd

Gabhaidh paramadairean faidhle ri URL poblach https://, URI data: suas ri 10 MB, no file_url de luchdachadh suas. Faidhlichean

Toradh

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"
  }
}
Na faidhlichean agad, do roghainnTha gach outputs[].url na lethbhreac air an stòradh againn: air a chumail gu bràth (air a phàigheadh gach GB-mìos) no 7 latha an-asgaidh, a rèir suidheachadh a’ chunntais agad no ?storage=.
An aon chruth air gach modailtype, url, content_type, width, height agus duration, airson dealbhan, bhidio agus fuaim le chèile. ’S e output nì toraidh a’ mhodail fhèin.
Raointean toraidh
images
array of object {url, content_type, file_name, file_size, width, height}Ìomhaighean a chaidh a chruthachadh leis a’ mhodail.

Barrachd mhodalan: Deasachadh Ìomhaighean

Do riochdairean AI: tha an duilleag seo mar Markdown aig https://doitong.com/gd/developers/models/bria/product-shot.md. Na modailean agus na treòraichean uile: https://doitong.com/developers/llms.txt