Bỏ qua đến nội dung

Bria Product Shot

Tích hợp

Id mô hình 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"

Yêu cầu này: 0,04 $ 40 tín dụng API Chạy trên trang này

Lấy khóa API
Bria AI · Hình ảnh

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc image_url
Thả tệp hoặc

URL ảnh sản phẩm để đặt vào cảnh phong cách sống; hình ảnh phải là jpeg, jpg, png, webp và không lớn hơn 12 MB. Nếu cũng cung cấp `image_file`, `image_url` được ưu tiên.

mặc định 1

Số lượng hình ảnh sản phẩm phong cách sống cho mỗi vị trí (`num_results`). Tổng số là số vị trí cần thiết × `num_results` đối với `placement_type=manual_placement`, hoặc `num_results` × 10 đối với `placement_type=automatic`.

Nâng cao ref_image_url · placement_type · scene_description · manual_placement_selection · optimize_description · fast · original_quality · shot_size · padding_values
mặc định
Thả tệp hoặc

URL hình ảnh tham chiếu để tạo phông nền hoặc cảnh mới cho ảnh sản phẩm, hỗ trợ jpeg, jpg, png và webp. Cung cấp chính xác một trong `scene_description` hoặc `ref_image_url`; URL trống được ghi là "". Khi cũng cung cấp `ref_image_file`, `ref_image_url` được ưu tiên.

placement_type mặc định manual_placement

Chế độ định vị sản phẩm, với hai tùy chọn thủ công: 'manual_placement' sử dụng các vị trí định sẵn được chọn qua 'manual_placement_selection', còn 'manual_padding' điều chỉnh vị trí và kích thước hình ảnh bằng phần đệm pixel quanh sản phẩm. Để giữ vị trí nguồn, chọn 'original'; để tạo kết quả trên 10 vị trí sản phẩm được đề xuất, chọn 'automatic'.

Lời nhắc chỉ bằng tiếng Anh, không có ký tự đặc biệt, mô tả cảnh hoặc phông nền cần tạo cho ảnh sản phẩm được cung cấp.

mặc định bottom_center

Các vị trí đặt trước dùng khi chọn placement_type=manual_placement. Chọn từ danh sách; có thể yêu cầu nhiều vị trí cùng lúc.

mặc định [1000,1000]

Kích thước đích của hình ảnh sản phẩm cuối, chỉ áp dụng cho placement_type=automatic hoặc placement_type=manual_placement. Để có kết quả tốt nhất, nên đạt khoảng 1,000,000 pixel tổng cộng.

Phần đệm pixel cho `placement_type=manual_padding`, được cung cấp dưới dạng [left, right, top, bottom]. Để chọn các giá trị này, trước tiên lấy ảnh cắt sản phẩm bằng API cắt sản phẩm và kiểm tra kích thước, sau đó truyền ảnh cắt đó vào API này cùng phần đệm mong muốn. Để có kết quả tối ưu, nên đạt khoảng 1,000,000 pixel tổng cộng sau khi thêm phần đệm.

POST /run/bria/product-shot?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Bria Product Shot

Đưa sản phẩm từ `image_url` vào cảnh được mô tả bởi `scene_description` hoặc hiển thị trong `ref_image_url`, không được dùng cả hai. `placement_type` có thể là original, automatic, manual_placement hoặc manual_padding, với mười vị trí `manual_placement_selection` và `shot_size` khoảng 1,000,000 pixel. `num_results` nằm trong khoảng 1 đến 4 và có chế độ `fast`.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
image_urlbắt buộc image
Kiểuurl · image
URL ảnh sản phẩm để đặt vào cảnh phong cách sống; hình ảnh phải là jpeg, jpg, png, webp và không lớn hơn 12 MB. Nếu cũng cung cấp `image_file`, `image_url` được ưu tiên.
scene_descriptiontùy chọn
Kiểustring | null
Lời nhắc chỉ bằng tiếng Anh, không có ký tự đặc biệt, mô tả cảnh hoặc phông nền cần tạo cho ảnh sản phẩm được cung cấp.
ref_image_urltùy chọn
Kiểuurl · image
Mặc định
URL hình ảnh tham chiếu để tạo phông nền hoặc cảnh mới cho ảnh sản phẩm, hỗ trợ jpeg, jpg, png và webp. Cung cấp chính xác một trong `scene_description` hoặc `ref_image_url`; URL trống được ghi là "". Khi cũng cung cấp `ref_image_file`, `ref_image_url` được ưu tiên.
optimize_descriptiontùy chọn
Kiểuboolean
Mặc địnhtrue
Cho biết tính năng tối ưu hóa mô tả cảnh có được bật hay không.
num_resultstùy chọn
Kiểuinteger
Mặc định1
1 – 4
Số lượng hình ảnh sản phẩm phong cách sống cho mỗi vị trí (`num_results`). Tổng số là số vị trí cần thiết × `num_results` đối với `placement_type=manual_placement`, hoặc `num_results` × 10 đối với `placement_type=automatic`.
fasttùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc chọn mô hình nhanh.
placement_typetùy chọn
Kiểuenum
Mặc địnhmanual_placement
originalautomaticmanual_placementmanual_padding
Chế độ định vị sản phẩm, với hai tùy chọn thủ công: 'manual_placement' sử dụng các vị trí định sẵn được chọn qua 'manual_placement_selection', còn 'manual_padding' điều chỉnh vị trí và kích thước hình ảnh bằng phần đệm pixel quanh sản phẩm. Để giữ vị trí nguồn, chọn 'original'; để tạo kết quả trên 10 vị trí sản phẩm được đề xuất, chọn 'automatic'.
original_qualitytùy chọn
Kiểuboolean
Mặc địnhfalse
Tùy chọn kích thước đầu ra chỉ dùng với `placement_type=original`: false thu nhỏ hình ảnh xuống 1 megapixel (1MP) mà không thay đổi tỷ lệ khung hình, còn true giữ nguyên kích thước đầu vào.
shot_sizetùy chọn
Kiểuinteger[]
Mặc định[1000,1000]
Kích thước đích của hình ảnh sản phẩm cuối, chỉ áp dụng cho placement_type=automatic hoặc placement_type=manual_placement. Để có kết quả tốt nhất, nên đạt khoảng 1,000,000 pixel tổng cộng.
manual_placement_selectiontùy chọn
Kiểuenum
Mặc địnhbottom_center
upper_leftupper_rightbottom_leftbottom_rightright_centerleft_centerupper_centerbottom_centercenter_verticalcenter_horizontal
Các vị trí đặt trước dùng khi chọn placement_type=manual_placement. Chọn từ danh sách; có thể yêu cầu nhiều vị trí cùng lúc.
padding_valuestùy chọn
Kiểuinteger[]
Phần đệm pixel cho `placement_type=manual_padding`, được cung cấp dưới dạng [left, right, top, bottom]. Để chọn các giá trị này, trước tiên lấy ảnh cắt sản phẩm bằng API cắt sản phẩm và kiểm tra kích thước, sau đó truyền ảnh cắt đó vào API này cùng phần đệm mong muốn. Để có kết quả tối ưu, nên đạt khoảng 1,000,000 pixel tổng cộng sau khi thêm phần đệm.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
images
array of object {url, content_type, file_name, file_size, width, height}Các hình ảnh được mô hình tạo sinh.

Thêm mô hình: Chỉnh sửa hình ảnh

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/bria/product-shot.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt