ข้ามไปยังเนื้อหา

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 แก้ไขภาพ อินพุตอ้างอิง #product-photography

จัดวางสินค้าในฉากไลฟ์สไตล์ใหม่จากคำอธิบายข้อความหรือรูปภาพอ้างอิง พร้อมตัวควบคุมตำแหน่ง

Bria AI · ภาพ

ผลลัพธ์แรกของคุณจะแสดงที่นี่

สร้างคำขอด้านล่างและเรียกใช้ด้วยคีย์ API ของคุณ เอาต์พุตจะถูกคัดลอกไปยังพื้นที่จัดเก็บของเรา และเก็บไว้ตลอดไปหรือฟรี 7 วัน

สร้างคำขอ

ตัวควบคุมสร้างจากสคีมาของโมเดล โค้ดและราคาจะอัปเดตเมื่อคุณเปลี่ยนค่า

•จำเป็น image_url
วางไฟล์ หรือ

URL รูปภาพสินค้าสำหรับจัดวางในฉากไลฟ์สไตล์ รูปภาพต้องเป็น jpeg, jpg, png, webp และมีขนาดไม่เกิน 12 MB หากระบุ `image_file` ด้วย ระบบจะให้ `image_url` มีลำดับความสำคัญสูงกว่า

ค่าเริ่มต้น 1

จำนวนรูปภาพสินค้าไลฟ์สไตล์ต่อการจัดวาง (`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' จะปรับตำแหน่งและขนาดรูปภาพด้วยระยะขอบพิกเซลรอบสินค้า หากต้องการคงตำแหน่งต้นฉบับ ให้เลือก 'original' หากต้องการสร้างผลลัพธ์ในตำแหน่งสินค้าแนะนำ 10 ตำแหน่ง ให้เลือก 'automatic'

พรอมต์ภาษาอังกฤษเท่านั้นที่ไม่มีอักขระพิเศษ ซึ่งอธิบายฉากหรือพื้นหลังที่จะสร้างสำหรับรูปภาพสินค้าที่ระบุ

ค่าเริ่มต้น bottom_center

ตำแหน่งที่กำหนดไว้ล่วงหน้าสำหรับใช้เมื่อเลือก placement_type=manual_placement เลือกจากรายการ และสามารถขอตำแหน่งหลายรายการพร้อมกันได้

ค่าเริ่มต้น [1000,1000]

ขนาดเป้าหมายสำหรับรูปภาพสินค้าสุดท้าย ใช้ได้เฉพาะกับ placement_type=automatic หรือ placement_type=manual_placement เพื่อผลลัพธ์ที่ดีที่สุด ควรมีพิกเซลรวมประมาณ 1,000,000 พิกเซล

การเติมพิกเซลรอบภาพสำหรับ `placement_type=manual_padding` โดยระบุเป็น [left, right, top, bottom] หากต้องการเลือกค่าเหล่านี้ ให้รับภาพไดคัตของผลิตภัณฑ์ก่อนโดยใช้ product cutout API และตรวจสอบขนาด จากนั้นส่งภาพไดคัตนั้นไปยัง API นี้พร้อมการเติมขอบที่ต้องการ เพื่อผลลัพธ์ที่เหมาะสม ควรให้จำนวนพิกเซลรวมหลังเติมขอบอยู่ที่ประมาณ 1,000,000 พิกเซล

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 พิกเซล `num_results` มีค่าตั้งแต่ 1 ถึง 4 และมีโหมด `fast` ให้ใช้งาน

พารามิเตอร์

ส่งชื่อมาตรฐานหรือชื่อดั้งเดิมอย่างใดอย่างหนึ่งเท่านั้น ห้ามส่งทั้งสองชื่อ ชื่อมาตรฐาน

ชื่อประเภท ค่าเริ่มต้นค่าที่อนุญาต คำอธิบาย
image_urlจำเป็น image
ประเภทurl · image
URL รูปภาพสินค้าสำหรับจัดวางในฉากไลฟ์สไตล์ รูปภาพต้องเป็น jpeg, jpg, png, webp และมีขนาดไม่เกิน 12 MB หากระบุ `image_file` ด้วย ระบบจะให้ `image_url` มีลำดับความสำคัญสูงกว่า
scene_descriptionไม่บังคับ
ประเภทstring | null
พรอมต์ภาษาอังกฤษเท่านั้นที่ไม่มีอักขระพิเศษ ซึ่งอธิบายฉากหรือพื้นหลังที่จะสร้างสำหรับรูปภาพสินค้าที่ระบุ
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
จำนวนรูปภาพสินค้าไลฟ์สไตล์ต่อการจัดวาง (`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' จะปรับตำแหน่งและขนาดรูปภาพด้วยระยะขอบพิกเซลรอบสินค้า หากต้องการคงตำแหน่งต้นฉบับ ให้เลือก 'original' หากต้องการสร้างผลลัพธ์ในตำแหน่งสินค้าแนะนำ 10 ตำแหน่ง ให้เลือก 'automatic'
original_qualityไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นfalse
ตัวเลือกการปรับขนาดเอาต์พุตที่ใช้เฉพาะกับ `placement_type=original`: false จะปรับขนาดรูปภาพเป็น 1 เมกะพิกเซล (1MP) โดยไม่เปลี่ยนอัตราส่วนภาพ ส่วน true จะคงขนาดอินพุตไว้
shot_sizeไม่บังคับ
ประเภทinteger[]
ค่าเริ่มต้น[1000,1000]
ขนาดเป้าหมายสำหรับรูปภาพสินค้าสุดท้าย ใช้ได้เฉพาะกับ placement_type=automatic หรือ placement_type=manual_placement เพื่อผลลัพธ์ที่ดีที่สุด ควรมีพิกเซลรวมประมาณ 1,000,000 พิกเซล
manual_placement_selectionไม่บังคับ
ประเภทenum
ค่าเริ่มต้นbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
ตำแหน่งที่กำหนดไว้ล่วงหน้าสำหรับใช้เมื่อเลือก placement_type=manual_placement เลือกจากรายการ และสามารถขอตำแหน่งหลายรายการพร้อมกันได้
padding_valuesไม่บังคับ
ประเภทinteger[]
การเติมพิกเซลรอบภาพสำหรับ `placement_type=manual_padding` โดยระบุเป็น [left, right, top, bottom] หากต้องการเลือกค่าเหล่านี้ ให้รับภาพไดคัตของผลิตภัณฑ์ก่อนโดยใช้ product cutout API และตรวจสอบขนาด จากนั้นส่งภาพไดคัตนั้นไปยัง API นี้พร้อมการเติมขอบที่ต้องการ เพื่อผลลัพธ์ที่เหมาะสม ควรให้จำนวนพิกเซลรวมหลังเติมขอบอยู่ที่ประมาณ 1,000,000 พิกเซล
จำเป็น ชื่อมาตรฐาน ซึ่งรองรับเช่นกัน

พารามิเตอร์ไฟล์รับ URL https:// สาธารณะ, data: URI ขนาดไม่เกิน 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/th/developers/models/bria/product-shot.md. โมเดลและคู่มือทั้งหมด: https://doitong.com/developers/llms.txt