Op den Inhalt sprangen

Bria Product Shot

Integréieren

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

Dës Ufro: 0,04 $ 40 API-Kreditter Op dëser Säit ausféieren

API-Schlëssel kréien
Bria AI · Bild

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

•obligatoresch image_url
Fichier erofzéien, oder

URL vun der Produktfoto fir d'Plazéierung an enger Lifestyle-Szen; d'Bild muss jpeg, jpg, png oder webp sinn an däerf net méi grouss wéi 12 MB sinn. Wann och en `image_file` uginn ass, huet `image_url` Prioritéit.

Standard 1

Unzuel vu Lifestyle-Produktbiller pro Plazéierung (`num_results`). D'Gesamtzuel ass d'Unzuel vun den erfuerderleche Plazéierungen × `num_results` fir `placement_type=manual_placement`, oder `num_results` × 10 fir `placement_type=automatic`.

Erweidert ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
Standard
Fichier erofzéien, oder

URL vun engem Referenzbild fir en neien Hannergrond oder eng nei Szen fir e Produktbild ze generéieren; jpeg, jpg, png a webp ginn ënnerstëtzt. Gitt genee een aus `scene_description` oder `ref_image_url` un; eng eidel URL gëtt als "" geschriwwen. Wann och `ref_image_file` uginn ass, huet `ref_image_url` Prioritéit.

placement_type Standard manual_placement

Modus fir d'Positioun vum Produkt mat zwou manuellen Optiounen: 'manual_placement' benotzt virdefinéiert Positiounen, déi iwwer 'manual_placement_selection' ausgewielt ginn, wärend 'manual_padding' d'Positioun an d'Gréisst iwwer Pixel-Padding ronderëm d'Produkt upasst. Fir d'Quellpositioun ze behalen, wielt 'original'; fir Resultater iwwer 10 recommandéiert Produktpositiounen ze generéieren, wielt 'automatic'.

Prompt nëmmen op Englesch, ouni Spezialzeechen, deen d'Szen oder den Hannergrond beschreift, dee fir d'Produktfoto erstallt soll ginn.

Standard bottom_center

Virdefinéiert Positiounen, déi benotzt ginn, wann placement_type=manual_placement ausgewielt ass. Wielt aus der Lëscht; verschidde Positioune kënnen zesumme gefrot ginn.

Standard [1000,1000]

Zildimensioune fir dat fäerdegt Produktbild, nëmme mat placement_type=automatic oder placement_type=manual_placement. Fir bescht Resultater soll d'Gesamtzuel ongeféier 1,000,000 Pixel sinn.

Pixel-Padding fir `placement_type=manual_padding`, uginn als [left, right, top, bottom]. Fir dës Wäerter ze bestëmmen, kritt fir d'éischt e Produkt-Ausschnëtt iwwer d'Produkt-Ausschnëtt-API a kontrolléiert seng Dimensiounen, da gitt dësen Ausschnëtt mat dem gewënschte Padding un dës API weider. Fir optimal Resultater soll d'Gesamtzuel nom Padding ongeféier 1,000,000 Pixel sinn.

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

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer Bria Product Shot

Setzt d'Produkt aus `image_url` an eng Szen, déi duerch `scene_description` beschriwwe gëtt oder an `ref_image_url` gewise gëtt, awer net béides. `placement_type` kann original, automatic, manual_placement oder manual_padding sinn, mat zéng Positioune fir `manual_placement_selection` an enger `shot_size` vun ongeféier 1,000,000 Pixel. `num_results` geet vun 1 bis 4, an e `fast`-Modus ass verfügbar.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
image_urlobligatoresch image
Typurl · image
URL vun der Produktfoto fir d'Plazéierung an enger Lifestyle-Szen; d'Bild muss jpeg, jpg, png oder webp sinn an däerf net méi grouss wéi 12 MB sinn. Wann och en `image_file` uginn ass, huet `image_url` Prioritéit.
scene_descriptionoptional
Typstring | null
Prompt nëmmen op Englesch, ouni Spezialzeechen, deen d'Szen oder den Hannergrond beschreift, dee fir d'Produktfoto erstallt soll ginn.
ref_image_urloptional
Typurl · image
Standard
URL vun engem Referenzbild fir en neien Hannergrond oder eng nei Szen fir e Produktbild ze generéieren; jpeg, jpg, png a webp ginn ënnerstëtzt. Gitt genee een aus `scene_description` oder `ref_image_url` un; eng eidel URL gëtt als "" geschriwwen. Wann och `ref_image_file` uginn ass, huet `ref_image_url` Prioritéit.
optimize_descriptionoptional
Typboolean
Standardtrue
Ob d'Optimiséierung vun der Szenebeschreiwung aktivéiert ass.
num_resultsoptional
Typinteger
Standard1
1 – 4
Unzuel vu Lifestyle-Produktbiller pro Plazéierung (`num_results`). D'Gesamtzuel ass d'Unzuel vun den erfuerderleche Plazéierungen × `num_results` fir `placement_type=manual_placement`, oder `num_results` × 10 fir `placement_type=automatic`.
fastoptional
Typboolean
Standardtrue
Steiert, ob de schnelle Modell ausgewielt gëtt.
placement_typeoptional
Typenum
Standardmanual_placement
originalautomaticmanual_placementmanual_padding
Modus fir d'Positioun vum Produkt mat zwou manuellen Optiounen: 'manual_placement' benotzt virdefinéiert Positiounen, déi iwwer 'manual_placement_selection' ausgewielt ginn, wärend 'manual_padding' d'Positioun an d'Gréisst iwwer Pixel-Padding ronderëm d'Produkt upasst. Fir d'Quellpositioun ze behalen, wielt 'original'; fir Resultater iwwer 10 recommandéiert Produktpositiounen ze generéieren, wielt 'automatic'.
original_qualityoptional
Typboolean
Standardfalse
Output-Gréisstoptioun, nëmme mat `placement_type=original` benotzbar: false skaléiert d'Bild op 1 Megapixel (1MP), ouni säin Aspektverhältnis z'änneren, wärend true d'Input-Dimensioune behält.
shot_sizeoptional
Typinteger[]
Standard[1000,1000]
Zildimensioune fir dat fäerdegt Produktbild, nëmme mat placement_type=automatic oder placement_type=manual_placement. Fir bescht Resultater soll d'Gesamtzuel ongeféier 1,000,000 Pixel sinn.
manual_placement_selectionoptional
Typenum
Standardbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Virdefinéiert Positiounen, déi benotzt ginn, wann placement_type=manual_placement ausgewielt ass. Wielt aus der Lëscht; verschidde Positioune kënnen zesumme gefrot ginn.
padding_valuesoptional
Typinteger[]
Pixel-Padding fir `placement_type=manual_padding`, uginn als [left, right, top, bottom]. Fir dës Wäerter ze bestëmmen, kritt fir d'éischt e Produkt-Ausschnëtt iwwer d'Produkt-Ausschnëtt-API a kontrolléiert seng Dimensiounen, da gitt dësen Ausschnëtt mat dem gewënschte Padding un dës API weider. Fir optimal Resultater soll d'Gesamtzuel nom Padding ongeféier 1,000,000 Pixel sinn.
obligatoresch Kanoneschen Numm, och akzeptéiert

Fichierparameter akzeptéieren eng ëffentlech https:// URL, eng data: URI bis zu 10 MB oder de file_url vun engem Upload. Fichieren

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"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
images
array of object {url, content_type, file_name, file_size, width, height}Biller, déi vum Modell erstallt goufen.

Méi Modeller: Bildbearbechtung

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/bria/product-shot.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt