Naar inhoud springen

Bria Product Shot

Integreren

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Deze request: $ 0,04 40 API-tegoed · ≈ ₽ 4,22 Op deze pagina uitvoeren

API-sleutel ophalen
Bria AI · Afbeelding

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

•verplicht image_url
Sleep een bestand hierheen of

URL van de productfoto voor plaatsing in een lifestyle-scène; de afbeelding moet jpeg, jpg, png of webp zijn en maximaal 12 MB groot. Als ook een `image_file` wordt aangeleverd, heeft `image_url` voorrang.

standaard 1

Aantal lifestyle-productafbeeldingen per plaatsing (`num_results`). Het totaal is het aantal vereiste plaatsingen × `num_results` voor `placement_type=manual_placement`, of `num_results` × 10 voor `placement_type=automatic`.

Geavanceerd ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
standaard
Sleep een bestand hierheen of

URL van de referentieafbeelding voor het genereren van een nieuwe achtergrond of scène voor een productfoto; jpeg, jpg, png en webp worden ondersteund. Lever exact één van `scene_description` of `ref_image_url` aan; een lege URL wordt geschreven als "". Als ook `ref_image_file` wordt aangeleverd, heeft `ref_image_url` voorrang.

placement_type standaard manual_placement

Modus voor productpositionering met twee handmatige opties: 'manual_placement' gebruikt vooraf gedefinieerde posities die via 'manual_placement_selection' zijn geselecteerd, terwijl 'manual_padding' de afbeeldingspositie en -grootte aanpast via pixelopvulling rond het product. Selecteer 'original' om de bronpositie te behouden; selecteer 'automatic' om resultaten voor 10 aanbevolen productposities te genereren.

Prompt uitsluitend in het Engels, zonder speciale tekens, die de scène of achtergrond beschrijft die voor de aangeleverde productfoto moet worden gemaakt.

standaard bottom_center

Vooraf ingestelde posities die moeten worden gebruikt wanneer placement_type=manual_placement is geselecteerd. Kies uit de lijst; meerdere posities kunnen samen worden aangevraagd.

standaard [1000,1000]

Doelafmetingen voor de uiteindelijke productafbeelding, alleen van toepassing op placement_type=automatic of placement_type=manual_placement. Richt voor het beste resultaat op ongeveer 1,000,000 pixels in totaal.

Pixelopvulling voor `placement_type=manual_padding`, aangeleverd als [left, right, top, bottom]. Verkrijg eerst een productuitsnede via de product cutout API en controleer de afmetingen om deze waarden te kiezen; geef die uitsnede vervolgens met de gewenste opvulling door aan deze API. Richt na het toevoegen van de opvulling voor optimale resultaten op ongeveer 1,000,000 pixels in totaal.

POST /run/bria/product-shot?wait=20 prijsopgave → $ 0,04
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over Bria Product Shot

Plaatst het product uit `image_url` in een scène die wordt beschreven door `scene_description` of getoond in `ref_image_url`, maar niet beide. `placement_type` kan original, automatic, manual_placement of manual_padding zijn, met tien posities voor `manual_placement_selection` en een `shot_size` van ongeveer 1,000,000 pixels. `num_results` loopt van 1 tot 4 en er is een `fast`-modus beschikbaar.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
image_urlverplicht image
Typeurl · image
URL van de productfoto voor plaatsing in een lifestyle-scène; de afbeelding moet jpeg, jpg, png of webp zijn en maximaal 12 MB groot. Als ook een `image_file` wordt aangeleverd, heeft `image_url` voorrang.
scene_descriptionoptioneel
Typestring | null
Prompt uitsluitend in het Engels, zonder speciale tekens, die de scène of achtergrond beschrijft die voor de aangeleverde productfoto moet worden gemaakt.
ref_image_urloptioneel
Typeurl · image
Standaard
URL van de referentieafbeelding voor het genereren van een nieuwe achtergrond of scène voor een productfoto; jpeg, jpg, png en webp worden ondersteund. Lever exact één van `scene_description` of `ref_image_url` aan; een lege URL wordt geschreven als "". Als ook `ref_image_file` wordt aangeleverd, heeft `ref_image_url` voorrang.
optimize_descriptionoptioneel
Typeboolean
Standaardtrue
Of optimalisatie van de scènebeschrijving is ingeschakeld.
num_resultsoptioneel
Typeinteger
Standaard1
1 – 4
Aantal lifestyle-productafbeeldingen per plaatsing (`num_results`). Het totaal is het aantal vereiste plaatsingen × `num_results` voor `placement_type=manual_placement`, of `num_results` × 10 voor `placement_type=automatic`.
fastoptioneel
Typeboolean
Standaardtrue
Bepaalt of het snelle model wordt geselecteerd.
placement_typeoptioneel
Typeenum
Standaardmanual_placement
originalautomaticmanual_placementmanual_padding
Modus voor productpositionering met twee handmatige opties: 'manual_placement' gebruikt vooraf gedefinieerde posities die via 'manual_placement_selection' zijn geselecteerd, terwijl 'manual_padding' de afbeeldingspositie en -grootte aanpast via pixelopvulling rond het product. Selecteer 'original' om de bronpositie te behouden; selecteer 'automatic' om resultaten voor 10 aanbevolen productposities te genereren.
original_qualityoptioneel
Typeboolean
Standaardfalse
Optie voor uitvoergrootte, alleen gebruikt met `placement_type=original`: false schaalt de afbeelding naar 1 megapixel (1MP) zonder de beeldverhouding te wijzigen, terwijl true de invoerafmetingen behoudt.
shot_sizeoptioneel
Typeinteger[]
Standaard[1000,1000]
Doelafmetingen voor de uiteindelijke productafbeelding, alleen van toepassing op placement_type=automatic of placement_type=manual_placement. Richt voor het beste resultaat op ongeveer 1,000,000 pixels in totaal.
manual_placement_selectionoptioneel
Typeenum
Standaardbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Vooraf ingestelde posities die moeten worden gebruikt wanneer placement_type=manual_placement is geselecteerd. Kies uit de lijst; meerdere posities kunnen samen worden aangevraagd.
padding_valuesoptioneel
Typeinteger[]
Pixelopvulling voor `placement_type=manual_padding`, aangeleverd als [left, right, top, bottom]. Verkrijg eerst een productuitsnede via de product cutout API en controleer de afmetingen om deze waarden te kiezen; geef die uitsnede vervolgens met de gewenste opvulling door aan deze API. Richt na het toevoegen van de opvulling voor optimale resultaten op ongeveer 1,000,000 pixels in totaal.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
images
array of object {url, content_type, file_name, file_size, width, height}Afbeeldingen die door het model zijn geproduceerd.

Meer modellen: Afbeelding bewerken

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/bria/product-shot.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt