İçeriğe geç

Bria Product Shot

Entegre et

Model kimliği 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"

Bu istek: $0,04 40 API kredisi Bu sayfada çalıştır

API anahtarı al
Bria AI · Görsel

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

•gerekli image_url
Dosyayı bırakın veya

Yaşam tarzı sahnesine yerleştirme için ürün fotoğrafı URL'si; görsel jpeg, jpg, png veya webp olmalı ve 12 MB'tan büyük olmamalıdır. `image_file` de sağlanırsa `image_url` önceliklidir.

varsayılan 1

Yerleştirme başına yaşam tarzı ürün görseli sayısı (`num_results`). Toplam sayı, `placement_type=manual_placement` için gereken yerleştirme sayısı × `num_results` veya `placement_type=automatic` için `num_results` × 10'dur.

Gelişmiş ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
varsayılan
Dosyayı bırakın veya

Ürün çekiminin yeni arka planını veya sahnesini oluşturmak için referans görsel URL'si; jpeg, jpg, png ve webp desteklenir. `scene_description` veya `ref_image_url` değerlerinden tam olarak birini sağlayın; boş URL "" olarak yazılır. `ref_image_file` de sağlanırsa `ref_image_url` önceliklidir.

placement_type varsayılan manual_placement

Ürün konumlandırma modu. İki manuel seçenek vardır: 'manual_placement', 'manual_placement_selection' üzerinden seçilen önceden tanımlı konumları kullanır; 'manual_padding', ürünün çevresindeki piksel boşluklarıyla görsel konumunu ve boyutunu ayarlar. Kaynak konumu korumak için 'original'; önerilen 10 ürün konumunda sonuçlar oluşturmak için 'automatic' seçin.

Sağlanan ürün fotoğrafı için oluşturulacak sahneyi veya arka planı açıklayan, özel karakter içermeyen yalnızca İngilizce istem.

varsayılan bottom_center

placement_type=manual_placement seçildiğinde kullanılacak önceden ayarlanmış konumlar. Listeden seçim yapın; birden çok konum birlikte istenebilir.

varsayılan [1000,1000]

Yalnızca placement_type=automatic veya placement_type=manual_placement için geçerli olan nihai ürün görselinin hedef boyutları. En iyi sonuçlar için toplamda yaklaşık 1.000.000 piksel hedefleyin.

`placement_type=manual_padding` için [left, right, top, bottom] olarak sağlanan piksel boşlukları. Bu değerleri seçmek için önce ürün cutout API'sini kullanarak bir ürün kesiti alın ve boyutlarını inceleyin; ardından istenen boşluklarla bu API'ye gönderin. En iyi sonuçlar için boşluklardan sonra toplamda yaklaşık 1.000.000 piksel hedefleyin.

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

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

Bria Product Shot hakkında

`image_url` içindeki ürünü `scene_description` ile açıklanan veya `ref_image_url` içinde gösterilen sahneye yerleştirir; ikisi birlikte kullanılamaz. `placement_type`, original, automatic, manual_placement veya manual_padding olabilir; on `manual_placement_selection` konumu ve yaklaşık 1,000,000 piksellik `shot_size` sunulur. `num_results` 1 ile 4 arasındadır ve `fast` modu kullanılabilir.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
image_urlgerekli image
Türurl · image
Yaşam tarzı sahnesine yerleştirme için ürün fotoğrafı URL'si; görsel jpeg, jpg, png veya webp olmalı ve 12 MB'tan büyük olmamalıdır. `image_file` de sağlanırsa `image_url` önceliklidir.
scene_descriptionisteğe bağlı
Türstring | null
Sağlanan ürün fotoğrafı için oluşturulacak sahneyi veya arka planı açıklayan, özel karakter içermeyen yalnızca İngilizce istem.
ref_image_urlisteğe bağlı
Türurl · image
Varsayılan
Ürün çekiminin yeni arka planını veya sahnesini oluşturmak için referans görsel URL'si; jpeg, jpg, png ve webp desteklenir. `scene_description` veya `ref_image_url` değerlerinden tam olarak birini sağlayın; boş URL "" olarak yazılır. `ref_image_file` de sağlanırsa `ref_image_url` önceliklidir.
optimize_descriptionisteğe bağlı
Türboolean
Varsayılantrue
Sahne açıklaması optimizasyonunun etkin olup olmadığı.
num_resultsisteğe bağlı
Türinteger
Varsayılan1
1 – 4
Yerleştirme başına yaşam tarzı ürün görseli sayısı (`num_results`). Toplam sayı, `placement_type=manual_placement` için gereken yerleştirme sayısı × `num_results` veya `placement_type=automatic` için `num_results` × 10'dur.
fastisteğe bağlı
Türboolean
Varsayılantrue
Hızlı modelin seçilip seçilmeyeceğini denetler.
placement_typeisteğe bağlı
Türenum
Varsayılanmanual_placement
originalautomaticmanual_placementmanual_padding
Ürün konumlandırma modu. İki manuel seçenek vardır: 'manual_placement', 'manual_placement_selection' üzerinden seçilen önceden tanımlı konumları kullanır; 'manual_padding', ürünün çevresindeki piksel boşluklarıyla görsel konumunu ve boyutunu ayarlar. Kaynak konumu korumak için 'original'; önerilen 10 ürün konumunda sonuçlar oluşturmak için 'automatic' seçin.
original_qualityisteğe bağlı
Türboolean
Varsayılanfalse
Yalnızca `placement_type=original` ile kullanılan çıktı boyutlandırma seçeneği: false, en-boy oranını değiştirmeden görseli 1 megapiksele (1MP) ölçekler; true, girdi boyutlarını korur.
shot_sizeisteğe bağlı
Türinteger[]
Varsayılan[1000,1000]
Yalnızca placement_type=automatic veya placement_type=manual_placement için geçerli olan nihai ürün görselinin hedef boyutları. En iyi sonuçlar için toplamda yaklaşık 1.000.000 piksel hedefleyin.
manual_placement_selectionisteğe bağlı
Türenum
Varsayılanbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
placement_type=manual_placement seçildiğinde kullanılacak önceden ayarlanmış konumlar. Listeden seçim yapın; birden çok konum birlikte istenebilir.
padding_valuesisteğe bağlı
Türinteger[]
`placement_type=manual_padding` için [left, right, top, bottom] olarak sağlanan piksel boşlukları. Bu değerleri seçmek için önce ürün cutout API'sini kullanarak bir ürün kesiti alın ve boyutlarını inceleyin; ardından istenen boşluklarla bu API'ye gönderin. En iyi sonuçlar için boşluklardan sonra toplamda yaklaşık 1.000.000 piksel hedefleyin.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

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"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
images
array of object {url, content_type, file_name, file_size, width, height}Model tarafından oluşturulan görseller.

Daha fazla model: Görsel Düzenleme

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/bria/product-shot.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt