Langkau ke kandungan

Bria Product Shot

Integrasikan

ID model 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"

Permintaan ini: $0.04 40 kredit API Jalankan pada halaman ini

Dapatkan kunci API
Bria AI · Imej

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan image_url
Lepaskan fail, atau

URL foto produk untuk diletakkan dalam adegan gaya hidup; imej mestilah jpeg, jpg, png, webp dan tidak melebihi 12 MB. Jika `image_file` turut dibekalkan, `image_url` diberi keutamaan.

lalai 1

Bilangan imej produk gaya hidup bagi setiap peletakan (`num_results`). Jumlahnya ialah bilangan peletakan yang diperlukan × `num_results` untuk `placement_type=manual_placement`, atau `num_results` × 10 untuk `placement_type=automatic`.

Lanjutan ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
lalai
Lepaskan fail, atau

URL imej rujukan untuk menjana latar belakang atau adegan baharu bagi foto produk, dengan sokongan jpeg, jpg, png dan webp. Bekalkan tepat satu daripada `scene_description` atau `ref_image_url`; URL kosong ditulis sebagai "". Apabila `ref_image_file` turut dibekalkan, `ref_image_url` diutamakan.

placement_type lalai manual_placement

Mod peletakan produk, dengan dua pilihan manual: 'manual_placement' menggunakan kedudukan dipratetap yang dipilih melalui 'manual_placement_selection', manakala 'manual_padding' melaraskan kedudukan dan saiz imej melalui padding piksel di sekeliling produk. Untuk mengekalkan kedudukan sumber, pilih 'original'; untuk menjana hasil merentasi 10 kedudukan produk yang disyorkan, pilih 'automatic'.

Prompt dalam bahasa Inggeris sahaja tanpa aksara khas, yang menerangkan adegan atau latar belakang untuk dicipta bagi foto produk yang dibekalkan.

lalai bottom_center

Kedudukan pratetap untuk digunakan apabila placement_type=manual_placement dipilih. Pilih daripada senarai; berbilang kedudukan boleh diminta bersama.

lalai [1000,1000]

Dimensi sasaran bagi imej produk akhir, hanya terpakai dengan placement_type=automatic atau placement_type=manual_placement. Untuk hasil terbaik, sasarkan kira-kira 1,000,000 piksel keseluruhan.

Padding piksel untuk `placement_type=manual_padding`, dibekalkan sebagai [left, right, top, bottom]. Untuk memilih nilai ini, dapatkan potongan produk terlebih dahulu menggunakan API potongan produk dan periksa dimensinya, kemudian hantar potongan itu kepada API ini dengan padding yang dikehendaki. Sasarkan sekitar 1,000,000 piksel keseluruhan selepas padding untuk hasil optimum.

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

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Bria Product Shot

Meletakkan produk daripada `image_url` ke dalam suasana yang diterangkan oleh `scene_description` atau ditunjukkan dalam `ref_image_url`, tetapi bukan kedua-duanya. `placement_type` boleh berupa original, automatic, manual_placement atau manual_padding, dengan sepuluh kedudukan `manual_placement_selection` dan `shot_size` kira-kira 1,000,000 piksel. `num_results` berjulat dari 1 hingga 4, dan mod `fast` tersedia.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
image_urldiperlukan image
Jenisurl · image
URL foto produk untuk diletakkan dalam adegan gaya hidup; imej mestilah jpeg, jpg, png, webp dan tidak melebihi 12 MB. Jika `image_file` turut dibekalkan, `image_url` diberi keutamaan.
scene_descriptionpilihan
Jenisstring | null
Prompt dalam bahasa Inggeris sahaja tanpa aksara khas, yang menerangkan adegan atau latar belakang untuk dicipta bagi foto produk yang dibekalkan.
ref_image_urlpilihan
Jenisurl · image
Lalai
URL imej rujukan untuk menjana latar belakang atau adegan baharu bagi foto produk, dengan sokongan jpeg, jpg, png dan webp. Bekalkan tepat satu daripada `scene_description` atau `ref_image_url`; URL kosong ditulis sebagai "". Apabila `ref_image_file` turut dibekalkan, `ref_image_url` diutamakan.
optimize_descriptionpilihan
Jenisboolean
Lalaitrue
Sama ada pengoptimuman penerangan adegan didayakan.
num_resultspilihan
Jenisinteger
Lalai1
1 – 4
Bilangan imej produk gaya hidup bagi setiap peletakan (`num_results`). Jumlahnya ialah bilangan peletakan yang diperlukan × `num_results` untuk `placement_type=manual_placement`, atau `num_results` × 10 untuk `placement_type=automatic`.
fastpilihan
Jenisboolean
Lalaitrue
Mengawal sama ada model pantas dipilih.
placement_typepilihan
Jenisenum
Lalaimanual_placement
originalautomaticmanual_placementmanual_padding
Mod peletakan produk, dengan dua pilihan manual: 'manual_placement' menggunakan kedudukan dipratetap yang dipilih melalui 'manual_placement_selection', manakala 'manual_padding' melaraskan kedudukan dan saiz imej melalui padding piksel di sekeliling produk. Untuk mengekalkan kedudukan sumber, pilih 'original'; untuk menjana hasil merentasi 10 kedudukan produk yang disyorkan, pilih 'automatic'.
original_qualitypilihan
Jenisboolean
Lalaifalse
Pilihan pensaizan output yang hanya digunakan dengan `placement_type=original`: false menskala imej kepada 1 megapiksel (1MP) tanpa mengubah nisbah bidangnya, manakala true mengekalkan dimensi input.
shot_sizepilihan
Jenisinteger[]
Lalai[1000,1000]
Dimensi sasaran bagi imej produk akhir, hanya terpakai dengan placement_type=automatic atau placement_type=manual_placement. Untuk hasil terbaik, sasarkan kira-kira 1,000,000 piksel keseluruhan.
manual_placement_selectionpilihan
Jenisenum
Lalaibottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Kedudukan pratetap untuk digunakan apabila placement_type=manual_placement dipilih. Pilih daripada senarai; berbilang kedudukan boleh diminta bersama.
padding_valuespilihan
Jenisinteger[]
Padding piksel untuk `placement_type=manual_padding`, dibekalkan sebagai [left, right, top, bottom]. Untuk memilih nilai ini, dapatkan potongan produk terlebih dahulu menggunakan API potongan produk dan periksa dimensinya, kemudian hantar potongan itu kepada API ini dengan padding yang dikehendaki. Sasarkan sekitar 1,000,000 piksel keseluruhan selepas padding untuk hasil optimum.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
images
array of object {url, content_type, file_name, file_size, width, height}Imej yang dihasilkan oleh model.

Lebih banyak model: Penyuntingan Imej

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/bria/product-shot.md. Semua model dan panduan: https://doitong.com/developers/llms.txt