Lompat ke konten

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 di halaman ini

Dapatkan kunci API
Bria AI · Gambar

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib image_url
Jatuhkan file, atau

URL foto produk untuk ditempatkan dalam adegan gaya hidup; gambar harus berupa jpeg, jpg, png, webp dan berukuran tidak lebih dari 12 MB. Jika `image_file` juga disediakan, `image_url` diprioritaskan.

bawaan 1

Jumlah gambar produk gaya hidup per penempatan (`num_results`). Totalnya adalah jumlah penempatan 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
bawaan
Jatuhkan file, atau

URL gambar referensi untuk membuat latar belakang atau adegan baru pada foto produk, dengan dukungan jpeg, jpg, png, dan webp. Sediakan tepat satu dari `scene_description` atau `ref_image_url`; URL kosong ditulis sebagai "". Jika `ref_image_file` juga disediakan, `ref_image_url` diprioritaskan.

placement_type bawaan manual_placement

Mode penempatan produk, dengan dua opsi manual: 'manual_placement' menggunakan posisi yang telah ditentukan melalui 'manual_placement_selection', sedangkan 'manual_padding' menyesuaikan posisi dan ukuran gambar melalui padding piksel di sekitar produk. Untuk mempertahankan posisi sumber, pilih 'original'; untuk membuat hasil pada 10 posisi produk yang direkomendasikan, pilih 'automatic'.

Prompt khusus bahasa Inggris tanpa karakter khusus, yang mendeskripsikan adegan atau latar belakang yang akan dibuat untuk foto produk yang disediakan.

bawaan bottom_center

Posisi prasetel yang digunakan ketika placement_type=manual_placement dipilih. Pilih dari daftar; beberapa posisi dapat diminta sekaligus.

bawaan [1000,1000]

Dimensi target untuk gambar produk akhir, hanya berlaku untuk placement_type=automatic atau placement_type=manual_placement. Untuk hasil terbaik, targetkan sekitar 1,000,000 piksel secara keseluruhan.

Padding piksel untuk `placement_type=manual_padding`, disediakan sebagai [left, right, top, bottom]. Untuk memilih nilai ini, terlebih dahulu dapatkan cutout produk menggunakan API cutout produk dan periksa dimensinya, lalu kirim cutout tersebut ke API ini dengan padding yang diinginkan. Targetkan sekitar 1,000,000 total piksel setelah padding untuk hasil optimal.

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

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Bria Product Shot

Menempatkan produk dari `image_url` ke dalam adegan yang dijelaskan oleh `scene_description` atau ditampilkan dalam `ref_image_url`, tetapi tidak keduanya. `placement_type` dapat berupa original, automatic, manual_placement, atau manual_padding, dengan sepuluh posisi `manual_placement_selection` dan `shot_size` sekitar 1,000,000 piksel. `num_results` berkisar dari 1 hingga 4, dan mode `fast` tersedia.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
image_urlwajib image
Tipeurl · image
URL foto produk untuk ditempatkan dalam adegan gaya hidup; gambar harus berupa jpeg, jpg, png, webp dan berukuran tidak lebih dari 12 MB. Jika `image_file` juga disediakan, `image_url` diprioritaskan.
scene_descriptionopsional
Tipestring | null
Prompt khusus bahasa Inggris tanpa karakter khusus, yang mendeskripsikan adegan atau latar belakang yang akan dibuat untuk foto produk yang disediakan.
ref_image_urlopsional
Tipeurl · image
Bawaan
URL gambar referensi untuk membuat latar belakang atau adegan baru pada foto produk, dengan dukungan jpeg, jpg, png, dan webp. Sediakan tepat satu dari `scene_description` atau `ref_image_url`; URL kosong ditulis sebagai "". Jika `ref_image_file` juga disediakan, `ref_image_url` diprioritaskan.
optimize_descriptionopsional
Tipeboolean
Bawaantrue
Apakah pengoptimalan deskripsi adegan diaktifkan.
num_resultsopsional
Tipeinteger
Bawaan1
1 – 4
Jumlah gambar produk gaya hidup per penempatan (`num_results`). Totalnya adalah jumlah penempatan yang diperlukan × `num_results` untuk `placement_type=manual_placement`, atau `num_results` × 10 untuk `placement_type=automatic`.
fastopsional
Tipeboolean
Bawaantrue
Mengontrol apakah fast model dipilih.
placement_typeopsional
Tipeenum
Bawaanmanual_placement
originalautomaticmanual_placementmanual_padding
Mode penempatan produk, dengan dua opsi manual: 'manual_placement' menggunakan posisi yang telah ditentukan melalui 'manual_placement_selection', sedangkan 'manual_padding' menyesuaikan posisi dan ukuran gambar melalui padding piksel di sekitar produk. Untuk mempertahankan posisi sumber, pilih 'original'; untuk membuat hasil pada 10 posisi produk yang direkomendasikan, pilih 'automatic'.
original_qualityopsional
Tipeboolean
Bawaanfalse
Opsi ukuran output yang hanya digunakan dengan `placement_type=original`: false menskalakan gambar menjadi 1 megapiksel (1MP) tanpa mengubah rasio aspeknya, sedangkan true mempertahankan dimensi input.
shot_sizeopsional
Tipeinteger[]
Bawaan[1000,1000]
Dimensi target untuk gambar produk akhir, hanya berlaku untuk placement_type=automatic atau placement_type=manual_placement. Untuk hasil terbaik, targetkan sekitar 1,000,000 piksel secara keseluruhan.
manual_placement_selectionopsional
Tipeenum
Bawaanbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Posisi prasetel yang digunakan ketika placement_type=manual_placement dipilih. Pilih dari daftar; beberapa posisi dapat diminta sekaligus.
padding_valuesopsional
Tipeinteger[]
Padding piksel untuk `placement_type=manual_padding`, disediakan sebagai [left, right, top, bottom]. Untuk memilih nilai ini, terlebih dahulu dapatkan cutout produk menggunakan API cutout produk dan periksa dimensinya, lalu kirim cutout tersebut ke API ini dengan padding yang diinginkan. Targetkan sekitar 1,000,000 total piksel setelah padding untuk hasil optimal.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
images
array of object {url, content_type, file_name, file_size, width, height}Gambar yang dihasilkan oleh model.

Model lainnya: Pengeditan Gambar

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