Gå til indhold

Bria Product Shot

Integrer

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

Denne anmodning: 0,04 $ 40 API-kreditter Kør den på denne side

Hent API-nøgle
Bria AI · Billede

Dit første resultat kommer her

Opret en anmodning nedenfor, og kør den med din API-nøgle. Output kopieres til vores lagring, gemt for altid eller 7 dage gratis.

Opret en anmodning

Kontrollerne genereres fra modellens skema. Koden og prisen opdateres, når du ændrer dem.

•påkrævet image_url
Slip en fil, eller

URL til produktfoto, der skal placeres i en livsstilsscene; billedet skal være jpeg, jpg, png eller webp og højst 12 MB. Hvis `image_file` også angives, har `image_url` prioritet.

standard 1

Antal livsstilsproduktbilleder pr. placering (`num_results`). Det samlede antal er antallet af nødvendige placeringer × `num_results` for `placement_type=manual_placement` eller `num_results` × 10 for `placement_type=automatic`.

Avanceret ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
standard
Slip en fil, eller

URL til referencebillede til generering af en ny baggrund eller scene til et produktfoto; jpeg, jpg, png og webp understøttes. Angiv præcis én af `scene_description` eller `ref_image_url`; en tom URL skrives som "". Hvis `ref_image_file` også angives, har `ref_image_url` prioritet.

placement_type standard manual_placement

Tilstand for produktplacering med to manuelle muligheder: 'manual_placement' bruger foruddefinerede placeringer valgt via 'manual_placement_selection', mens 'manual_padding' justerer billedets placering og størrelse via pixel-padding omkring produktet. Vælg 'original' for at bevare kildeplaceringen; vælg 'automatic' for at generere resultater på tværs af 10 anbefalede produktplaceringer.

Prompt, kun på engelsk og uden specialtegn, der beskriver scenen eller baggrunden, som skal oprettes til det angivne produktfoto.

standard bottom_center

Forudindstillede placeringer, der skal bruges, når placement_type=manual_placement er valgt. Vælg fra listen; flere placeringer kan anmodes samtidig.

standard [1000,1000]

Måldimensioner for det endelige produktbillede, kun relevante for placement_type=automatic eller placement_type=manual_placement. For de bedste resultater bør det samlede antal pixels være cirka 1,000,000.

Pixel-padding til `placement_type=manual_padding`, angivet som [left, right, top, bottom]. Hent først et produktudsnit via product cutout API'et, og undersøg dets dimensioner; send derefter udsnittet til dette API med den ønskede padding. Sigt efter omkring 1,000,000 pixels i alt efter padding for optimale resultater.

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

Kør denne anmodning

Din nøgle forbliver i denne browser: Den sendes kun til Doitong API og gemmes kun i localStorage, hvis du markerer Husk. Hent en API-nøgle

Om Bria Product Shot

Placerer produktet fra `image_url` i en scene beskrevet af `scene_description` eller vist i `ref_image_url`, men ikke begge. `placement_type` kan være original, automatic, manual_placement eller manual_padding med ti positioner i `manual_placement_selection` og en `shot_size` på cirka 1,000,000 pixels. `num_results` går fra 1 til 4, og en `fast`-tilstand er tilgængelig.

Parametre

Send enten det kanoniske navn eller det oprindelige navn, ikke begge. Kanoniske navne

NavnType StandardTilladt Beskrivelse
image_urlpåkrævet image
Typeurl · image
URL til produktfoto, der skal placeres i en livsstilsscene; billedet skal være jpeg, jpg, png eller webp og højst 12 MB. Hvis `image_file` også angives, har `image_url` prioritet.
scene_descriptionvalgfri
Typestring | null
Prompt, kun på engelsk og uden specialtegn, der beskriver scenen eller baggrunden, som skal oprettes til det angivne produktfoto.
ref_image_urlvalgfri
Typeurl · image
Standard
URL til referencebillede til generering af en ny baggrund eller scene til et produktfoto; jpeg, jpg, png og webp understøttes. Angiv præcis én af `scene_description` eller `ref_image_url`; en tom URL skrives som "". Hvis `ref_image_file` også angives, har `ref_image_url` prioritet.
optimize_descriptionvalgfri
Typeboolean
Standardtrue
Om optimering af scenebeskrivelsen er aktiveret.
num_resultsvalgfri
Typeinteger
Standard1
1 – 4
Antal livsstilsproduktbilleder pr. placering (`num_results`). Det samlede antal er antallet af nødvendige placeringer × `num_results` for `placement_type=manual_placement` eller `num_results` × 10 for `placement_type=automatic`.
fastvalgfri
Typeboolean
Standardtrue
Styrer, om den hurtige model vælges.
placement_typevalgfri
Typeenum
Standardmanual_placement
originalautomaticmanual_placementmanual_padding
Tilstand for produktplacering med to manuelle muligheder: 'manual_placement' bruger foruddefinerede placeringer valgt via 'manual_placement_selection', mens 'manual_padding' justerer billedets placering og størrelse via pixel-padding omkring produktet. Vælg 'original' for at bevare kildeplaceringen; vælg 'automatic' for at generere resultater på tværs af 10 anbefalede produktplaceringer.
original_qualityvalgfri
Typeboolean
Standardfalse
Outputstørrelse, der kun bruges sammen med `placement_type=original`: false skalerer billedet til 1 megapixel (1MP) uden at ændre højde-bredde-forholdet, mens true bevarer inputdimensionerne.
shot_sizevalgfri
Typeinteger[]
Standard[1000,1000]
Måldimensioner for det endelige produktbillede, kun relevante for placement_type=automatic eller placement_type=manual_placement. For de bedste resultater bør det samlede antal pixels være cirka 1,000,000.
manual_placement_selectionvalgfri
Typeenum
Standardbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Forudindstillede placeringer, der skal bruges, når placement_type=manual_placement er valgt. Vælg fra listen; flere placeringer kan anmodes samtidig.
padding_valuesvalgfri
Typeinteger[]
Pixel-padding til `placement_type=manual_padding`, angivet som [left, right, top, bottom]. Hent først et produktudsnit via product cutout API'et, og undersøg dets dimensioner; send derefter udsnittet til dette API med den ønskede padding. Sigt efter omkring 1,000,000 pixels i alt efter padding for optimale resultater.
påkrævet Kanonisk navn, også accepteret

Filparametre accepterer en offentlig https://-URL, en data:-URI på op til 10 MB eller file_url fra en upload. Filer

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"
  }
}
Dine filer, dit valgHver outputs[].url er en kopi på vores lagring: gemt for altid (betales pr. GB-måned) eller 7 dage gratis, afhængigt af din kontoindstilling eller ?storage=.
Samme struktur for alle modellertype, url, content_type, width, height og duration for billeder, video og lyd. output er modellens eget resultatobjekt.
Outputfelter
images
array of object {url, content_type, file_name, file_size, width, height}Billeder produceret af modellen.

Flere modeller: Billedredigering

Til AI-agenter: Denne side som Markdown findes på https://doitong.com/da/developers/models/bria/product-shot.md. Alle modeller og vejledninger: https://doitong.com/developers/llms.txt