Zum Inhalt springen

Bria Product Shot

Integrieren

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"

Diese Anfrage: 0,04 $ 40 API-Credits Auf dieser Seite ausführen

API-Schlüssel abrufen
Bria AI · Bild

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

•erforderlich image_url
Datei ablegen oder

URL des Produktfotos zur Platzierung in einer Lifestyle-Szene; das Bild muss jpeg, jpg, png oder webp sein und darf höchstens 12 MB groß sein. Wenn auch eine `image_file` angegeben wird, hat `image_url` Vorrang.

Standard 1

Anzahl der Lifestyle-Produktbilder pro Platzierung (`num_results`). Die Gesamtzahl entspricht der Anzahl erforderlicher Platzierungen × `num_results` für `placement_type=manual_placement` oder `num_results` × 10 für `placement_type=automatic`.

Erweitert ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
Standard
Datei ablegen oder

URL des Referenzbildes zur Generierung eines neuen Hintergrunds oder einer neuen Szene für ein Produktfoto; jpeg, jpg, png und webp werden unterstützt. Geben Sie genau eine der Optionen `scene_description` oder `ref_image_url` an; eine leere URL wird als "" geschrieben. Wenn auch `ref_image_file` angegeben wird, hat `ref_image_url` Vorrang.

placement_type Standard manual_placement

Positionierungsmodus für Produkte mit zwei manuellen Optionen: 'manual_placement' verwendet über 'manual_placement_selection' ausgewählte vordefinierte Positionen, während 'manual_padding' die Bildposition und -größe durch Pixelabstände um das Produkt anpasst. Um die Quellposition beizubehalten, wählen Sie 'original'; um Ergebnisse für 10 empfohlene Produktpositionen zu erzeugen, wählen Sie 'automatic'.

Nur englischer Prompt ohne Sonderzeichen, der die für das angegebene Produktfoto zu erstellende Szene oder den Hintergrund beschreibt.

Standard bottom_center

Vordefinierte Positionen für placement_type=manual_placement. Wählen Sie aus der Liste; mehrere Positionen können gemeinsam angefordert werden.

Standard [1000,1000]

Zielmaße des finalen Produktbildes, nur für placement_type=automatic oder placement_type=manual_placement. Für optimale Ergebnisse sollten insgesamt etwa 1,000,000 Pixel angestrebt werden.

Pixelabstände für `placement_type=manual_padding`, angegeben als [left, right, top, bottom]. Ermitteln Sie diese Werte zunächst, indem Sie über die Product-Cutout-API eine Produktfreistellung abrufen und deren Maße prüfen, und übergeben Sie diese Freistellung anschließend mit dem gewünschten Abstand an diese API. Für optimale Ergebnisse sollten nach dem Abstand insgesamt etwa 1,000,000 Pixel erreicht werden.

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

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über Bria Product Shot

Setzt das Produkt aus `image_url` in eine durch `scene_description` beschriebene oder in `ref_image_url` gezeigte Szene ein, jedoch nicht beides. `placement_type` kann original, automatic, manual_placement oder manual_padding sein; es gibt zehn Positionen für `manual_placement_selection` und eine `shot_size` von etwa 1,000,000 Pixeln. `num_results` reicht von 1 bis 4, außerdem ist ein `fast`-Modus verfügbar.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
image_urlerforderlich image
Typurl · image
URL des Produktfotos zur Platzierung in einer Lifestyle-Szene; das Bild muss jpeg, jpg, png oder webp sein und darf höchstens 12 MB groß sein. Wenn auch eine `image_file` angegeben wird, hat `image_url` Vorrang.
scene_descriptionoptional
Typstring | null
Nur englischer Prompt ohne Sonderzeichen, der die für das angegebene Produktfoto zu erstellende Szene oder den Hintergrund beschreibt.
ref_image_urloptional
Typurl · image
Standard
URL des Referenzbildes zur Generierung eines neuen Hintergrunds oder einer neuen Szene für ein Produktfoto; jpeg, jpg, png und webp werden unterstützt. Geben Sie genau eine der Optionen `scene_description` oder `ref_image_url` an; eine leere URL wird als "" geschrieben. Wenn auch `ref_image_file` angegeben wird, hat `ref_image_url` Vorrang.
optimize_descriptionoptional
Typboolean
Standardtrue
Gibt an, ob die Optimierung der Szenenbeschreibung aktiviert ist.
num_resultsoptional
Typinteger
Standard1
1 – 4
Anzahl der Lifestyle-Produktbilder pro Platzierung (`num_results`). Die Gesamtzahl entspricht der Anzahl erforderlicher Platzierungen × `num_results` für `placement_type=manual_placement` oder `num_results` × 10 für `placement_type=automatic`.
fastoptional
Typboolean
Standardtrue
Steuert, ob das schnelle Modell ausgewählt wird.
placement_typeoptional
Typenum
Standardmanual_placement
originalautomaticmanual_placementmanual_padding
Positionierungsmodus für Produkte mit zwei manuellen Optionen: 'manual_placement' verwendet über 'manual_placement_selection' ausgewählte vordefinierte Positionen, während 'manual_padding' die Bildposition und -größe durch Pixelabstände um das Produkt anpasst. Um die Quellposition beizubehalten, wählen Sie 'original'; um Ergebnisse für 10 empfohlene Produktpositionen zu erzeugen, wählen Sie 'automatic'.
original_qualityoptional
Typboolean
Standardfalse
Ausgabegröße, die nur mit `placement_type=original` verwendet wird: false skaliert das Bild auf 1 Megapixel (1MP), ohne das Seitenverhältnis zu ändern, während true die Eingabemaße beibehält.
shot_sizeoptional
Typinteger[]
Standard[1000,1000]
Zielmaße des finalen Produktbildes, nur für placement_type=automatic oder placement_type=manual_placement. Für optimale Ergebnisse sollten insgesamt etwa 1,000,000 Pixel angestrebt werden.
manual_placement_selectionoptional
Typenum
Standardbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Vordefinierte Positionen für placement_type=manual_placement. Wählen Sie aus der Liste; mehrere Positionen können gemeinsam angefordert werden.
padding_valuesoptional
Typinteger[]
Pixelabstände für `placement_type=manual_padding`, angegeben als [left, right, top, bottom]. Ermitteln Sie diese Werte zunächst, indem Sie über die Product-Cutout-API eine Produktfreistellung abrufen und deren Maße prüfen, und übergeben Sie diese Freistellung anschließend mit dem gewünschten Abstand an diese API. Für optimale Ergebnisse sollten nach dem Abstand insgesamt etwa 1,000,000 Pixel erreicht werden.
erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

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"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
images
array of object {url, content_type, file_name, file_size, width, height}Vom Modell erzeugte Bilder.

Weitere Modelle: Bildbearbeitung

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/bria/product-shot.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt