Preskoči na vsebino

Bria Product Shot

Integracija

ID modela 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"

Ta zahteva: 0,04 $ 40 API kreditov Zaženi na tej strani

Pridobi ključ API
Bria AI · Slika

Tukaj bo vaš prvi rezultat

Spodaj sestavite zahtevo in jo zaženite s svojim ključem API. Izhodi se kopirajo v našo shrambo, kjer se hranijo za vedno ali 7 dni brezplačno.

Ustvari zahtevo

Kontrolniki se ustvarijo iz sheme modela. Koda in cena se posodobita, ko ju spreminjate.

•obvezno image_url
Spustite datoteko ali

URL fotografije izdelka za umestitev v življenjski prizor; slika mora biti jpeg, jpg, png ali webp in velika največ 12 MB. Če je poslan tudi `image_file`, ima prednost `image_url`.

privzeto 1

Število življenjskih slik izdelka na umestitev (`num_results`). Skupno število je število zahtevanih umestitev × `num_results` za `placement_type=manual_placement` oziroma `num_results` × 10 za `placement_type=automatic`.

Napredno ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
privzeto
Spustite datoteko ali

URL referenčne slike za ustvarjanje novega ozadja ali prizora fotografije izdelka; podprti so jpeg, jpg, png in webp. Navedite natanko eno od `scene_description` ali `ref_image_url`; prazen URL je zapisan kot "". Če je poslan tudi `ref_image_file`, ima prednost `ref_image_url`.

placement_type privzeto manual_placement

Način postavitve izdelka z dvema ročnima možnostma: 'manual_placement' uporablja vnaprej določene položaje, izbrane prek 'manual_placement_selection', 'manual_padding' pa prilagodi položaj in velikost slike z odmiki v slikovnih pikah okoli izdelka. Za ohranitev izvornega položaja izberite 'original'; za rezultate na 10 priporočenih položajih izdelka izberite 'automatic'.

Poziv samo v angleščini brez posebnih znakov, ki opisuje prizor ali ozadje za ustvarjanje za poslano fotografijo izdelka.

privzeto bottom_center

Prednastavljeni položaji za uporabo, ko je izbran placement_type=manual_placement. Izberite s seznama; skupaj lahko zahtevate več položajev.

privzeto [1000,1000]

Ciljne mere končne slike izdelka, uporabne samo z placement_type=automatic ali placement_type=manual_placement. Za najboljše rezultate ciljajte na približno 1,000,000 slikovnih pik.

Odmiki v slikovnih pikah za `placement_type=manual_padding`, poslani kot [left, right, top, bottom]. Za izbiro vrednosti najprej pridobite izrez izdelka z API-jem za izreze izdelkov in preverite njegove mere, nato ta izrez pošljite temu API-ju z želenimi odmiki. Za optimalne rezultate ciljajte na približno 1,000,000 skupnih slikovnih pik po dodajanju odmikov.

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"

Zaženi to zahtevo

Vaš ključ ostane v tem brskalniku: pošlje se samo v Doitong API in shrani v localStorage samo, če označite možnost Zapomni si. Pridobi ključ API

O modelu Bria Product Shot

Izdelek iz `image_url` postavi v prizor, opisan v `scene_description` ali prikazan v `ref_image_url`, vendar ne v obeh. `placement_type` je lahko original, automatic, manual_placement ali manual_padding, na voljo je deset položajev `manual_placement_selection`, `shot_size` pa znaša približno 1,000,000 slikovnih pik. `num_results` je od 1 do 4, na voljo pa je tudi način `fast`.

Parametri

Pošlji kanonično ali izvorno ime, ne obeh. Kanonična imena

ImeVrsta PrivzetoDovoljeno Opis
image_urlobvezno image
Vrstaurl · image
URL fotografije izdelka za umestitev v življenjski prizor; slika mora biti jpeg, jpg, png ali webp in velika največ 12 MB. Če je poslan tudi `image_file`, ima prednost `image_url`.
scene_descriptionneobvezno
Vrstastring | null
Poziv samo v angleščini brez posebnih znakov, ki opisuje prizor ali ozadje za ustvarjanje za poslano fotografijo izdelka.
ref_image_urlneobvezno
Vrstaurl · image
Privzeto
URL referenčne slike za ustvarjanje novega ozadja ali prizora fotografije izdelka; podprti so jpeg, jpg, png in webp. Navedite natanko eno od `scene_description` ali `ref_image_url`; prazen URL je zapisan kot "". Če je poslan tudi `ref_image_file`, ima prednost `ref_image_url`.
optimize_descriptionneobvezno
Vrstaboolean
Privzetotrue
Ali je optimizacija opisa prizora omogočena.
num_resultsneobvezno
Vrstainteger
Privzeto1
1 – 4
Število življenjskih slik izdelka na umestitev (`num_results`). Skupno število je število zahtevanih umestitev × `num_results` za `placement_type=manual_placement` oziroma `num_results` × 10 za `placement_type=automatic`.
fastneobvezno
Vrstaboolean
Privzetotrue
Določa, ali je izbran hitri model.
placement_typeneobvezno
Vrstaenum
Privzetomanual_placement
originalautomaticmanual_placementmanual_padding
Način postavitve izdelka z dvema ročnima možnostma: 'manual_placement' uporablja vnaprej določene položaje, izbrane prek 'manual_placement_selection', 'manual_padding' pa prilagodi položaj in velikost slike z odmiki v slikovnih pikah okoli izdelka. Za ohranitev izvornega položaja izberite 'original'; za rezultate na 10 priporočenih položajih izdelka izberite 'automatic'.
original_qualityneobvezno
Vrstaboolean
Privzetofalse
Možnost velikosti izhoda, uporabljena samo z `placement_type=original`: false sliko spremeni na 1 megapiksel (1MP) brez spreminjanja razmerja stranic, true pa ohrani vhodne mere.
shot_sizeneobvezno
Vrstainteger[]
Privzeto[1000,1000]
Ciljne mere končne slike izdelka, uporabne samo z placement_type=automatic ali placement_type=manual_placement. Za najboljše rezultate ciljajte na približno 1,000,000 slikovnih pik.
manual_placement_selectionneobvezno
Vrstaenum
Privzetobottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Prednastavljeni položaji za uporabo, ko je izbran placement_type=manual_placement. Izberite s seznama; skupaj lahko zahtevate več položajev.
padding_valuesneobvezno
Vrstainteger[]
Odmiki v slikovnih pikah za `placement_type=manual_padding`, poslani kot [left, right, top, bottom]. Za izbiro vrednosti najprej pridobite izrez izdelka z API-jem za izreze izdelkov in preverite njegove mere, nato ta izrez pošljite temu API-ju z želenimi odmiki. Za optimalne rezultate ciljajte na približno 1,000,000 skupnih slikovnih pik po dodajanju odmikov.
obvezno Kanonično ime, prav tako sprejeto

Parametri datotek sprejmejo javni https:// URL, podatkovni URI data: do 10 MB ali file_url naložene datoteke. Datoteke

Izhod

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"
  }
}
Vaše datoteke, vaša izbiraVsak outputs[].url je kopija v naši shrambi: hrani se za vedno (plačilo na GB-mesec) ali 7 dni brezplačno, glede na nastavitev računa ali ?storage=.
Enaka struktura pri vsakem modelutype, url, content_type, width, height in duration za slike, videoposnetke in zvok. output je lasten objekt rezultata modela.
Polja izhoda
images
array of object {url, content_type, file_name, file_size, width, height}Slike, ustvarjene z modelom.

Več modelov: Urejanje slik

Za agente AI: ta stran je v obliki Markdown na voljo na https://doitong.com/sl/developers/models/bria/product-shot.md. Vsi modeli in vodniki: https://doitong.com/developers/llms.txt