Bria

BRIA Product Shot

bria-product-shot

Ein Bildbearbeitungsmodell für E-Commerce-Produktbilder, das Produkte natürlich in Szenenhintergründe einfügt, die aus Text oder Referenzbildern generiert werden, und dabei Texturen sowie Markendetails bewahrt

bria-product-shot

Preise

bria-product-shot per image

Einzelpreis	$0.0575

Positionierung und Kurzprofil

bria-product-shot ist ein Bildbearbeitungsmodell für die Produktvisualisierung im E-Commerce. Es nimmt Produktbilder entgegen und erhält eine Szenenbeschreibung oder ein Szenenreferenzbild als Eingabe, platziert das Produkt automatisch in einen neuen Hintergrund, bewahrt Texturen, Logos und Markendetails und gibt Produktbilder aus, die für die kommerzielle Präsentation geeignet sind. Es eignet sich für Entwickler und E-Commerce-Teams, die Produktszenenbilder in großem Umfang generieren und physische Fotoshootings sowie manuelle Composings reduzieren möchten.

Kernhighlights

Speziell für die Produktplatzierung trainiert, natürliche Licht- und Schattenwirkung – optimiert für die Konsistenz von Beleuchtung, Schatten und Größenverhältnissen zwischen Produkt und Szene, sodass die Compositing-Ergebnisse näher an echten Aufnahmen liegen.
Bewahrung von Produktdetails und Markenelementen – während der Szenensynthese bleiben wichtige Details wie Produkttexturen, Logos und Markenkennzeichen erhalten.
Szenensteuerung per Text oder Referenzbild – der neue Hintergrund lässt sich wahlweise über eine englische Szenenbeschreibung oder ein Szenenreferenzbild festlegen, wodurch die Ausgabe flexibel gesteuert werden kann.
Voreingestellte Position und Originalgröße optional – die Position des Produkts im Bild kann manuell vorgegeben werden, oder es wird in Originalgröße und -position ausgegeben.

Funktionsbeschreibung

Szenengenerierung per Textbeschreibung: Mit einer englischen Szenenbeschreibung (maximal 1000 Zeichen) generiert das Modell automatisch einen Hintergrund und platziert das Produkt darin; eine automatische Erweiterung der Beschreibung zur Anreicherung der Szenendetails wird unterstützt.

Szenenstil per Referenzbild: Wird ein Szenenreferenzbild hochgeladen, folgt das Modell dessen Hintergrundstil bei der Synthese des Produktbildes – ideal für die Batch-Produktion mit einheitlichem visuellem Stil.

Steuerung von Produktposition und -größe: Der manuelle Platzierungsmodus erlaubt die Auswahl aus zehn voreingestellten Positionen für das Produkt; der Originalmodus bewahrt Eingabegröße und -position und bietet optional den Verzicht auf Skalierung auf etwa 1 MP.

Umschalten des Schnellmodus: Standardmäßig ist der Schnellmodus aktiviert, um die Generierung zu beschleunigen; nach dem Deaktivieren wird das Standardmodell verwendet, sodass sich je nach Bedarf zwischen Geschwindigkeit und Qualität abwägen lässt.

Anwendungsfälle

E-Commerce-Betrieb: Batch-Szenarisierung von Produkthauptbildern – Produktbilder und Szenenbeschreibungen eingeben und Produktbilder mit verschiedenen Hintergründen in großem Umfang generieren, für Produktdetailseiten und Werbematerialien.
Marketingteams: Erstellung mehrerer Stilvarianten – Referenzbilder zur Steuerung unterschiedlicher Hintergrundstile nutzen und schnell Marketingbilder desselben Produkts in mehreren Stilen für Social Media und Aktionsseiten produzieren.
Markeninhaber: Schnelle Synthese von Neuheiten-Visuals – im Prozess der Produkteinführung Produktbilder in Alltagsszenen platzieren, physische Fotoshootings reduzieren und die Veröffentlichung von visuellem Material beschleunigen.
Entwickler: Integration in automatisierte Workflows – über die einheitliche Schnittstelle von HiAPI.ai aufrufen und die Szenensynthese von Produktbildern in die Content-Produktionspipeline einbetten, um eine skalierte automatische Verarbeitung zu erreichen.

Einschränkungen und Auswahlhinweise

Das Modell bietet eine Bild-zu-Bild-Bearbeitungsfunktion und erfordert zwingend ein Produktbild als Eingabe; eine reine Text-zu-Bild-Generierung wird nicht unterstützt. Die Ausgabe ist ein statisches Bild und umfasst keine Videos oder 3D-Inhalte. Der Fokus liegt auf der Szenensynthese für E-Commerce-Produkte; die allgemeine kreative Bildgenerierung ist kein Zielanwendungsfall. Für die kommerzielle Nutzung sind die entsprechenden Lizenz- und Compliance-Bedingungen zu beachten. Wenn kreative Bilder von Grund auf generiert oder nicht produktbezogene Bearbeitungen durchgeführt werden sollen, ist ein allgemeines Bildgenerierungsmodell zu wählen.

Neuigkeiten

Changelog ansehen →

Neues Modell Neues Modell bria-product-shot – Produktszenenbilder Oct 20, 2026

Häufige Fragen

Alle Fragen ansehen →

Können Szenenbeschreibung und Szenenreferenzbild zusammen verwendet werden?

Nein, nur eines von beiden. Wenn Sie eine englische Szenenbeschreibung (Prompt) schreiben, übergeben Sie kein Referenzbild; wenn Sie anhand eines Referenzbilds generieren, schreiben Sie keine Beschreibung. Beim Umschalten im Playground wird der Inhalt der jeweils anderen Option automatisch geleert.
Muss die Szenariobeschreibung auf Englisch sein?

Ja. Bitte beschreibe das neue Szenario oder den Hintergrund im Prompt auf Englisch, mit maximal 1000 Zeichen; erkennt das Playground Chinesisch, wird ein Hinweis zum Umschreiben angezeigt.
Was ist die optimierte Beschreibung?

Wenn aktiviert, wird deine Szenenbeschreibung automatisch erweitert; standardmäßig aktiviert; wirkt nur im Szenenbeschreibungsmodus, im Referenzbildmodus wird sie nicht gesendet.
Welche Möglichkeiten gibt es, Produkte zu platzieren?

Die voreingestellte Position (manual_placement, Standard; Szenenbeschreibung oder Referenzbild möglich) platziert das Produkt an einer festgelegten Position auf der Leinwand, standardmäßig unten zentriert; bei quadratischer Eingabe ergibt die Messung eine Ausgabe von 1024×1024. Bei „Position beibehalten“ (original) werden Position und Größenverhältnis des Produkts aus dem Ausgangsbild übernommen.

Generierungsaufgabe erstellen

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.

Idempotency-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.

Body

modelstringPflicht

Aktueller Festwert: bria-product-shot

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für bria-product-shot und Route default — siehe Parametertabelle unten.

fastbooleanOptionalStandard: true

Faster generation; turn off for the standard model.

promptstringOptionalminLength 1maxLength 1000

English description of the new scene or background. Use either prompt or reference_image_url, not both.

image_urlstringPflichtminLength 1pattern ^https?://

Public URL of the product photo (JPEG, PNG or WEBP, up to 12 MB).

placement_typestringOptionalStandard: "manual_placement"

manual_placement puts the product at a preset position (with a scene description or a scene reference; measured 1024×1024 for square input); original keeps its position and the input size.

Optionen:manual_placementoriginal

original_qualitybooleanOptionalStandard: false

Keep the input size instead of scaling to about 1 MP. Applies to original only.

reference_image_urlstringOptionalminLength 1pattern ^https?://

Image whose scene or background style to follow. Use either prompt or reference_image_url, not both.

optimize_descriptionbooleanOptionalStandard: true

Expand the scene description automatically. Applies to prompt only.

manual_placement_selectionstringOptionalStandard: "bottom_center"

Preset product position. Applies to manual_placement only.

Optionen:bottom_centerupper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_center

Alle anzeigen (2)

center_verticalcenter_horizontal

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.

urlstringPflicht

Pflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.

whenstringOptionalStandard: "final"

Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.

Optionen:final

storagestringOptionalStandard: "temp"

Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.

Optionen:temppersistent

Anfragebeispiele

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bria-product-shot",
  "input": {
    "fast": true,
    "image_url": "…",
    "placement_type": "manual_placement",
    "original_quality": false,
    "optimize_description": true,
    "manual_placement_selection": "bottom_center"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "bria-product-shot",
    input: {
      "fast": true,
      "image_url": "…",
      "placement_type": "manual_placement",
      "original_quality": false,
      "optimize_description": true,
      "manual_placement_selection": "bottom_center"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "bria-product-shot",
        "input": {
          "fast": True,
          "image_url": "…",
          "placement_type": "manual_placement",
          "original_quality": False,
          "optimize_description": True,
          "manual_placement_selection": "bottom_center"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Aufgabendetails abrufen

GET https://api.hiapi.ai/v1/tasks/:id

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

queued Eingereiht, noch nicht gestartet. handling In Verarbeitung. archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet. success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben). fail Endzustand: fehlgeschlagen (error wird zurückgegeben). Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-Sekunden des Endzustands; vor Abschluss stets 0.

outputarrayOptional

Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).

Array [ object ]

Array-Elemente

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

Antwortbeispiele

Erfolg

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In Bearbeitung (nicht final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fehlgeschlagen

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}