Μετάβαση στο περιεχόμενο

Bria Product Shot

Ενσωμάτωση

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"

Αυτό το αίτημα: 0,04 $ 40 πιστώσεις API Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
Bria AI · Εικόνα

Το πρώτο σας αποτέλεσμα θα εμφανιστεί εδώ

Δημιουργήστε ένα αίτημα παρακάτω και εκτελέστε το με το κλειδί API σας. Οι έξοδοι αντιγράφονται στην αποθήκευσή μας και διατηρούνται για πάντα ή 7 ημέρες δωρεάν.

Δημιουργία αιτήματος

Τα στοιχεία ελέγχου δημιουργούνται από το σχήμα του μοντέλου. Ο κώδικας και η τιμή ενημερώνονται καθώς τα αλλάζετε.

•απαιτείται image_url
Αποθέστε ένα αρχείο ή

URL φωτογραφίας προϊόντος για τοποθέτηση σε σκηνή lifestyle· η εικόνα πρέπει να είναι jpeg, jpg, png, webp και έως 12 MB. Αν παρέχεται επίσης `image_file`, το `image_url` έχει προτεραιότητα.

προεπιλογή 1

Πλήθος εικόνων προϊόντος lifestyle ανά τοποθέτηση (`num_results`). Το σύνολο είναι ο αριθμός των απαιτούμενων τοποθετήσεων × `num_results` για `placement_type=manual_placement` ή `num_results` × 10 για `placement_type=automatic`.

Για προχωρημένους ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
προεπιλογή
Αποθέστε ένα αρχείο ή

URL εικόνας αναφοράς για την παραγωγή νέου φόντου ή σκηνής για φωτογραφία προϊόντος, με υποστήριξη jpeg, jpg, png και webp. Παρέχετε ακριβώς ένα από τα `scene_description` ή `ref_image_url`· ένα κενό URL γράφεται ως "". Όταν παρέχεται επίσης `ref_image_file`, υπερισχύει το `ref_image_url`.

placement_type προεπιλογή manual_placement

Λειτουργία τοποθέτησης προϊόντος, με δύο χειροκίνητες επιλογές: το 'manual_placement' χρησιμοποιεί προκαθορισμένες θέσεις που επιλέγονται μέσω του 'manual_placement_selection', ενώ το 'manual_padding' προσαρμόζει τη θέση και το μέγεθος της εικόνας μέσω padding σε pixel γύρω από το προϊόν. Για διατήρηση της αρχικής θέσης, επιλέξτε 'original'· για παραγωγή αποτελεσμάτων σε 10 προτεινόμενες θέσεις προϊόντος, επιλέξτε 'automatic'.

Prompt μόνο στα Αγγλικά, χωρίς ειδικούς χαρακτήρες, που περιγράφει τη σκηνή ή το φόντο που θα δημιουργηθεί για την παρεχόμενη φωτογραφία προϊόντος.

προεπιλογή bottom_center

Προκαθορισμένες θέσεις που θα χρησιμοποιηθούν όταν έχει επιλεγεί placement_type=manual_placement. Επιλέξτε από τη λίστα· μπορούν να ζητηθούν πολλές θέσεις μαζί.

προεπιλογή [1000,1000]

Επιθυμητές διαστάσεις για την τελική εικόνα προϊόντος, εφαρμόσιμες μόνο με placement_type=automatic ή placement_type=manual_placement. Για βέλτιστα αποτελέσματα, στοχεύστε σε περίπου 1,000,000 pixel συνολικά.

Padding σε pixel για `placement_type=manual_padding`, που παρέχεται ως [left, right, top, bottom]. Για να επιλέξετε αυτές τις τιμές, λάβετε πρώτα ένα cutout προϊόντος μέσω του product cutout API και ελέγξτε τις διαστάσεις του, έπειτα περάστε αυτό το cutout σε αυτό το API με το επιθυμητό padding. Για βέλτιστα αποτελέσματα, στοχεύστε σε περίπου 1,000,000 συνολικά pixel μετά το padding.

POST /run/bria/product-shot?wait=20 προσφορά → 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"

Εκτέλεση αυτού του αιτήματος

Το κλειδί σας παραμένει σε αυτό το πρόγραμμα περιήγησης: αποστέλλεται μόνο στο Doitong API και αποθηκεύεται (localStorage) μόνο αν ενεργοποιήσετε την επιλογή «Να απομνημονεύεται». Λήψη κλειδιού API

Σχετικά με το Bria Product Shot

Τοποθετεί το προϊόν από το `image_url` σε σκηνή που περιγράφεται από το `scene_description` ή εμφανίζεται στο `ref_image_url`, αλλά όχι και στα δύο. Το `placement_type` μπορεί να είναι original, automatic, manual_placement ή manual_padding, με δέκα θέσεις `manual_placement_selection` και `shot_size` περίπου 1,000,000 pixel. Το `num_results` κυμαίνεται από 1 έως 4 και είναι διαθέσιμη λειτουργία `fast`.

Παράμετροι

Στείλτε είτε το κανονικό όνομα είτε το εγγενές όνομα, όχι και τα δύο. Κανονικά ονόματα

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
image_urlαπαιτείται image
Τύποςurl · image
URL φωτογραφίας προϊόντος για τοποθέτηση σε σκηνή lifestyle· η εικόνα πρέπει να είναι jpeg, jpg, png, webp και έως 12 MB. Αν παρέχεται επίσης `image_file`, το `image_url` έχει προτεραιότητα.
scene_descriptionπροαιρετικό
Τύποςstring | null
Prompt μόνο στα Αγγλικά, χωρίς ειδικούς χαρακτήρες, που περιγράφει τη σκηνή ή το φόντο που θα δημιουργηθεί για την παρεχόμενη φωτογραφία προϊόντος.
ref_image_urlπροαιρετικό
Τύποςurl · image
Προεπιλογή
URL εικόνας αναφοράς για την παραγωγή νέου φόντου ή σκηνής για φωτογραφία προϊόντος, με υποστήριξη jpeg, jpg, png και webp. Παρέχετε ακριβώς ένα από τα `scene_description` ή `ref_image_url`· ένα κενό URL γράφεται ως "". Όταν παρέχεται επίσης `ref_image_file`, υπερισχύει το `ref_image_url`.
optimize_descriptionπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Αν είναι ενεργοποιημένη η βελτιστοποίηση περιγραφής σκηνής.
num_resultsπροαιρετικό
Τύποςinteger
Προεπιλογή1
1 – 4
Πλήθος εικόνων προϊόντος lifestyle ανά τοποθέτηση (`num_results`). Το σύνολο είναι ο αριθμός των απαιτούμενων τοποθετήσεων × `num_results` για `placement_type=manual_placement` ή `num_results` × 10 για `placement_type=automatic`.
fastπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ελέγχει αν έχει επιλεγεί το γρήγορο μοντέλο.
placement_typeπροαιρετικό
Τύποςenum
Προεπιλογήmanual_placement
originalautomaticmanual_placementmanual_padding
Λειτουργία τοποθέτησης προϊόντος, με δύο χειροκίνητες επιλογές: το 'manual_placement' χρησιμοποιεί προκαθορισμένες θέσεις που επιλέγονται μέσω του 'manual_placement_selection', ενώ το 'manual_padding' προσαρμόζει τη θέση και το μέγεθος της εικόνας μέσω padding σε pixel γύρω από το προϊόν. Για διατήρηση της αρχικής θέσης, επιλέξτε 'original'· για παραγωγή αποτελεσμάτων σε 10 προτεινόμενες θέσεις προϊόντος, επιλέξτε 'automatic'.
original_qualityπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Επιλογή μεγέθους εξόδου που χρησιμοποιείται μόνο με `placement_type=original`: false κλιμακώνει την εικόνα σε 1 megapixel (1MP) χωρίς αλλαγή της αναλογίας διαστάσεων, ενώ true διατηρεί τις διαστάσεις εισόδου.
shot_sizeπροαιρετικό
Τύποςinteger[]
Προεπιλογή[1000,1000]
Επιθυμητές διαστάσεις για την τελική εικόνα προϊόντος, εφαρμόσιμες μόνο με placement_type=automatic ή placement_type=manual_placement. Για βέλτιστα αποτελέσματα, στοχεύστε σε περίπου 1,000,000 pixel συνολικά.
manual_placement_selectionπροαιρετικό
Τύποςenum
Προεπιλογήbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Προκαθορισμένες θέσεις που θα χρησιμοποιηθούν όταν έχει επιλεγεί placement_type=manual_placement. Επιλέξτε από τη λίστα· μπορούν να ζητηθούν πολλές θέσεις μαζί.
padding_valuesπροαιρετικό
Τύποςinteger[]
Padding σε pixel για `placement_type=manual_padding`, που παρέχεται ως [left, right, top, bottom]. Για να επιλέξετε αυτές τις τιμές, λάβετε πρώτα ένα cutout προϊόντος μέσω του product cutout API και ελέγξτε τις διαστάσεις του, έπειτα περάστε αυτό το cutout σε αυτό το API με το επιθυμητό padding. Για βέλτιστα αποτελέσματα, στοχεύστε σε περίπου 1,000,000 συνολικά pixel μετά το padding.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

Οι παράμετροι αρχείων δέχονται ένα δημόσιο URL https://, ένα URI data: έως 10 MB ή το file_url μιας μεταφόρτωσης. Αρχεία

Έξοδος

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"
  }
}
Τα αρχεία σας, η επιλογή σαςΚάθε outputs[].url είναι ένα αντίγραφο στην αποθήκευσή μας: διατηρείται για πάντα (χρέωση ανά GB-μήνα) ή 7 ημέρες δωρεάν, σύμφωνα με τη ρύθμιση του λογαριασμού σας ή ?storage=.
Ίδια μορφή σε κάθε μοντέλοtype, url, content_type, width, height και duration, τόσο για εικόνες όσο και για βίντεο και ήχο. Το output είναι το αντικείμενο αποτελέσματος του ίδιου του μοντέλου.
Πεδία εξόδου
images
array of object {url, content_type, file_name, file_size, width, height}Εικόνες που παράγονται από το μοντέλο.

Περισσότερα μοντέλα: Επεξεργασία εικόνας

Για πράκτορες AI: αυτή η σελίδα σε Markdown βρίσκεται στη διεύθυνση https://doitong.com/el/developers/models/bria/product-shot.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt