Ruka hadi kwenye maudhui

Bria Product Shot

Unganisha

Kitambulisho cha modeli 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"

Ombi hili: $ 0.04 salio za API 40 Iendeshe kwenye ukurasa huu

Pata ufunguo wa API
Bria AI · Picha

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

•inahitajika image_url
Dondosha faili, au

URL ya picha ya bidhaa kwa kuwekwa kwenye mandhari ya mtindo wa maisha; picha lazima iwe jpeg, jpg, png, webp na isiwe kubwa kuliko 12 MB. Ikiwa `image_file` pia imetolewa, `image_url` hupewa kipaumbele.

chaguomsingi 1

Idadi ya picha za bidhaa za mtindo wa maisha kwa uwekaji (`num_results`). Jumla ni idadi ya uwekaji unaohitajika × `num_results` kwa `placement_type=manual_placement`, au `num_results` × 10 kwa `placement_type=automatic`.

Ya kina ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
chaguomsingi
Dondosha faili, au

URL ya picha ya marejeleo kwa kuzalisha mandharinyuma au mandhari mpya ya picha ya bidhaa, ikisaidia jpeg, jpg, png, na webp. Toa moja pekee kati ya `scene_description` au `ref_image_url`; URL tupu huandikwa kama "". `ref_image_url` hupewa kipaumbele `ref_image_file` pia ikitolewa.

placement_type chaguomsingi manual_placement

Hali ya kuweka bidhaa, yenye chaguo mbili za mwongozo: 'manual_placement' hutumia nafasi zilizobainishwa mapema zinazochaguliwa kupitia 'manual_placement_selection', huku 'manual_padding' ikirekebisha nafasi na ukubwa wa picha kupitia nafasi ya pikseli kuzunguka bidhaa. Ili kuhifadhi nafasi ya chanzo, chagua 'original'; ili kuzalisha matokeo katika nafasi 10 zinazopendekezwa za bidhaa, chagua 'automatic'.

Kidokezo cha Kiingereza pekee kisicho na herufi maalum, kinachoeleza mandhari au mandharinyuma ya kuunda kwa picha ya bidhaa iliyotolewa.

chaguomsingi bottom_center

Nafasi zilizowekwa tayari za kutumia wakati placement_type=manual_placement imechaguliwa. Chagua kutoka kwenye orodha; nafasi nyingi zinaweza kuombwa pamoja.

chaguomsingi [1000,1000]

Vipimo lengwa vya picha ya mwisho ya bidhaa, vinavyotumika tu kwa placement_type=automatic au placement_type=manual_placement. Kwa matokeo bora, lenga takriban pikseli 1,000,000 kwa jumla.

Nafasi ya pikseli kwa `placement_type=manual_padding`, inayotolewa kama [left, right, top, bottom]. Ili kuchagua thamani hizi, kwanza pata kipande cha bidhaa kwa kutumia API ya product cutout na kagua vipimo vyake, kisha tuma kipande hicho kwa API hii pamoja na nafasi unayotaka. Lenga takriban pikseli 1,000,000 baada ya kuongeza nafasi kwa matokeo bora.

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

Endesha ombi hili

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Pata ufunguo wa API

Kuhusu Bria Product Shot

Huunganisha bidhaa kutoka `image_url` kwenye tukio linaloelezwa na `scene_description` au kuonyeshwa katika `ref_image_url`, lakini si zote mbili. `placement_type` inaweza kuwa original, automatic, manual_placement au manual_padding, ikiwa na nafasi kumi za `manual_placement_selection` na `shot_size` ya takriban pikseli 1,000,000. `num_results` ni kutoka 1 hadi 4, na hali ya `fast` inapatikana.

Vigezo

Tuma jina rasmi au jina asilia, si yote mawili. Majina rasmi

JinaAina ChaguomsingiInaruhusiwa Maelezo
image_urlinahitajika image
Ainaurl · image
URL ya picha ya bidhaa kwa kuwekwa kwenye mandhari ya mtindo wa maisha; picha lazima iwe jpeg, jpg, png, webp na isiwe kubwa kuliko 12 MB. Ikiwa `image_file` pia imetolewa, `image_url` hupewa kipaumbele.
scene_descriptionsi lazima
Ainastring | null
Kidokezo cha Kiingereza pekee kisicho na herufi maalum, kinachoeleza mandhari au mandharinyuma ya kuunda kwa picha ya bidhaa iliyotolewa.
ref_image_urlsi lazima
Ainaurl · image
Chaguomsingi
URL ya picha ya marejeleo kwa kuzalisha mandharinyuma au mandhari mpya ya picha ya bidhaa, ikisaidia jpeg, jpg, png, na webp. Toa moja pekee kati ya `scene_description` au `ref_image_url`; URL tupu huandikwa kama "". `ref_image_url` hupewa kipaumbele `ref_image_file` pia ikitolewa.
optimize_descriptionsi lazima
Ainaboolean
Chaguomsingitrue
Ikiwa uboreshaji wa maelezo ya mandhari umewashwa.
num_resultssi lazima
Ainainteger
Chaguomsingi1
1 – 4
Idadi ya picha za bidhaa za mtindo wa maisha kwa uwekaji (`num_results`). Jumla ni idadi ya uwekaji unaohitajika × `num_results` kwa `placement_type=manual_placement`, au `num_results` × 10 kwa `placement_type=automatic`.
fastsi lazima
Ainaboolean
Chaguomsingitrue
Hudhibiti iwapo modeli ya haraka itachaguliwa.
placement_typesi lazima
Ainaenum
Chaguomsingimanual_placement
originalautomaticmanual_placementmanual_padding
Hali ya kuweka bidhaa, yenye chaguo mbili za mwongozo: 'manual_placement' hutumia nafasi zilizobainishwa mapema zinazochaguliwa kupitia 'manual_placement_selection', huku 'manual_padding' ikirekebisha nafasi na ukubwa wa picha kupitia nafasi ya pikseli kuzunguka bidhaa. Ili kuhifadhi nafasi ya chanzo, chagua 'original'; ili kuzalisha matokeo katika nafasi 10 zinazopendekezwa za bidhaa, chagua 'automatic'.
original_qualitysi lazima
Ainaboolean
Chaguomsingifalse
Chaguo la ukubwa wa tokeo linalotumika tu na `placement_type=original`: false hupunguza picha hadi megapikseli 1 (1MP) bila kubadilisha uwiano wake, huku true ikihifadhi vipimo vya ingizo.
shot_sizesi lazima
Ainainteger[]
Chaguomsingi[1000,1000]
Vipimo lengwa vya picha ya mwisho ya bidhaa, vinavyotumika tu kwa placement_type=automatic au placement_type=manual_placement. Kwa matokeo bora, lenga takriban pikseli 1,000,000 kwa jumla.
manual_placement_selectionsi lazima
Ainaenum
Chaguomsingibottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Nafasi zilizowekwa tayari za kutumia wakati placement_type=manual_placement imechaguliwa. Chagua kutoka kwenye orodha; nafasi nyingi zinaweza kuombwa pamoja.
padding_valuessi lazima
Ainainteger[]
Nafasi ya pikseli kwa `placement_type=manual_padding`, inayotolewa kama [left, right, top, bottom]. Ili kuchagua thamani hizi, kwanza pata kipande cha bidhaa kwa kutumia API ya product cutout na kagua vipimo vyake, kisha tuma kipande hicho kwa API hii pamoja na nafasi unayotaka. Lenga takriban pikseli 1,000,000 baada ya kuongeza nafasi kwa matokeo bora.
inahitajika Jina rasmi, pia linakubalika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

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"
  }
}
Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.
Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.
Sehemu za tokeo
images
array of object {url, content_type, file_name, file_size, width, height}Picha zilizozalishwa na modeli.

Miundo zaidi: Uhariri wa Picha

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/bria/product-shot.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt