Pereiti prie turinio

Bria Product Shot

Integruoti

Modelio 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"

Ši užklausa: 0,04 $ 40 API kreditų Paleisti šiame puslapyje

Gauti API raktą
Bria AI · Vaizdas

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

•privaloma image_url
Įmeskite failą arba

Produkto nuotraukos URL, skirtas įkomponuoti į gyvenimo būdo sceną; vaizdas turi būti jpeg, jpg, png arba webp formato ir ne didesnis nei 12 MB. Jei taip pat pateiktas `image_file`, pirmenybė teikiama `image_url`.

numatytoji 1

Gyvenimo būdo produkto vaizdų skaičius vienai vietai (`num_results`). Bendra reikšmė yra reikiamų vietų skaičius × `num_results`, kai `placement_type=manual_placement`, arba `num_results` × 10, kai `placement_type=automatic`.

Išplėstiniai ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
numatytoji
Įmeskite failą arba

Nuorodos vaizdo URL, skirtas naujam produkto nuotraukos fonui arba scenai generuoti; palaikomi jpeg, jpg, png ir webp. Pateikite tik vieną iš `scene_description` arba `ref_image_url`; tuščias URL įrašomas kaip "". Jei taip pat pateiktas `ref_image_file`, pirmenybė teikiama `ref_image_url`.

placement_type numatytoji manual_placement

Produkto padėties nustatymo režimas su dviem rankiniais variantais: 'manual_placement' naudoja iš anksto nustatytas padėtis, pasirinktas per 'manual_placement_selection', o 'manual_padding' koreguoja vaizdo padėtį ir dydį naudodamas pikselių paraštes aplink produktą. Norėdami išlaikyti šaltinio padėtį, pasirinkite 'original'; norėdami generuoti rezultatus 10 rekomenduojamų produkto padėčių, pasirinkite 'automatic'.

Tik anglų kalba pateiktas raginys be specialiųjų simbolių, apibūdinantis sceną arba foną, kurį reikia sukurti pateiktai produkto nuotraukai.

numatytoji bottom_center

Naudojamos iš anksto nustatytos padėtys, kai pasirinkta placement_type=manual_placement. Pasirinkite iš sąrašo; galima kartu nurodyti kelias padėtis.

numatytoji [1000,1000]

Galutinio produkto vaizdo tiksliniai matmenys, taikomi tik su placement_type=automatic arba placement_type=manual_placement. Geriausiems rezultatams siekite maždaug 1,000,000 pikselių.

Pikselių paraštės, skirtos `placement_type=manual_padding`, pateikiamos kaip [left, right, top, bottom]. Norėdami pasirinkti šias reikšmes, pirmiausia gaukite produkto iškarpą naudodami produkto iškarpos API ir patikrinkite jos matmenis, tada perduokite šią iškarpą šiai API kartu su norimomis paraštėmis. Kad rezultatai būtų optimalūs, po paraščių siekite maždaug 1,000,000 pikselių.

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

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Bria Product Shot

Perkelia produktą iš `image_url` į sceną, aprašytą `scene_description` arba parodytą `ref_image_url`, bet ne į abu. `placement_type` gali būti original, automatic, manual_placement arba manual_padding, su dešimčia `manual_placement_selection` pozicijų ir maždaug 1,000,000 pikselių `shot_size`. `num_results` svyruoja nuo 1 iki 4, galimas ir `fast` režimas.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
image_urlprivaloma image
Tipasurl · image
Produkto nuotraukos URL, skirtas įkomponuoti į gyvenimo būdo sceną; vaizdas turi būti jpeg, jpg, png arba webp formato ir ne didesnis nei 12 MB. Jei taip pat pateiktas `image_file`, pirmenybė teikiama `image_url`.
scene_descriptionneprivalomas
Tipasstring | null
Tik anglų kalba pateiktas raginys be specialiųjų simbolių, apibūdinantis sceną arba foną, kurį reikia sukurti pateiktai produkto nuotraukai.
ref_image_urlneprivalomas
Tipasurl · image
Numatytoji reikšmė
Nuorodos vaizdo URL, skirtas naujam produkto nuotraukos fonui arba scenai generuoti; palaikomi jpeg, jpg, png ir webp. Pateikite tik vieną iš `scene_description` arba `ref_image_url`; tuščias URL įrašomas kaip "". Jei taip pat pateiktas `ref_image_file`, pirmenybė teikiama `ref_image_url`.
optimize_descriptionneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Ar įjungtas scenos aprašymo optimizavimas.
num_resultsneprivalomas
Tipasinteger
Numatytoji reikšmė1
1 – 4
Gyvenimo būdo produkto vaizdų skaičius vienai vietai (`num_results`). Bendra reikšmė yra reikiamų vietų skaičius × `num_results`, kai `placement_type=manual_placement`, arba `num_results` × 10, kai `placement_type=automatic`.
fastneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Valdo, ar pasirinktas spartusis modelis.
placement_typeneprivalomas
Tipasenum
Numatytoji reikšmėmanual_placement
originalautomaticmanual_placementmanual_padding
Produkto padėties nustatymo režimas su dviem rankiniais variantais: 'manual_placement' naudoja iš anksto nustatytas padėtis, pasirinktas per 'manual_placement_selection', o 'manual_padding' koreguoja vaizdo padėtį ir dydį naudodamas pikselių paraštes aplink produktą. Norėdami išlaikyti šaltinio padėtį, pasirinkite 'original'; norėdami generuoti rezultatus 10 rekomenduojamų produkto padėčių, pasirinkite 'automatic'.
original_qualityneprivalomas
Tipasboolean
Numatytoji reikšmėfalse
Išvesties dydžio nustatymas, naudojamas tik su `placement_type=original`: false pakeičia vaizdo dydį į 1 megapikselį (1MP), nekeisdamas vaizdo formato, o true išlaiko įvesties matmenis.
shot_sizeneprivalomas
Tipasinteger[]
Numatytoji reikšmė[1000,1000]
Galutinio produkto vaizdo tiksliniai matmenys, taikomi tik su placement_type=automatic arba placement_type=manual_placement. Geriausiems rezultatams siekite maždaug 1,000,000 pikselių.
manual_placement_selectionneprivalomas
Tipasenum
Numatytoji reikšmėbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Naudojamos iš anksto nustatytos padėtys, kai pasirinkta placement_type=manual_placement. Pasirinkite iš sąrašo; galima kartu nurodyti kelias padėtis.
padding_valuesneprivalomas
Tipasinteger[]
Pikselių paraštės, skirtos `placement_type=manual_padding`, pateikiamos kaip [left, right, top, bottom]. Norėdami pasirinkti šias reikšmes, pirmiausia gaukite produkto iškarpą naudodami produkto iškarpos API ir patikrinkite jos matmenis, tada perduokite šią iškarpą šiai API kartu su norimomis paraštėmis. Kad rezultatai būtų optimalūs, po paraščių siekite maždaug 1,000,000 pikselių.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

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ūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
images
array of object {url, content_type, file_name, file_size, width, height}Modelio sukurti vaizdai.

Daugiau modelių: Vaizdo redagavimas

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/bria/product-shot.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt