콘텐츠로 건너뛰기

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 · 이미지

첫 번째 결과가 여기에 표시됩니다

아래에서 요청을 작성하고 API 키로 실행하세요. 출력은 스토리지에 복사되며, 영구 보관하거나 7일 동안 무료로 보관할 수 있습니다.

요청 만들기

컨트롤은 모델 스키마에서 생성됩니다. 값을 변경하면 코드와 가격이 업데이트됩니다.

•필수 image_url
파일을 끌어다 놓거나

라이프스타일 장면에 배치할 상품 사진 URL입니다. 이미지는 jpeg, jpg, png, webp 형식이어야 하며 12 MB 이하여야 합니다. `image_file`도 제공하면 `image_url`이 우선합니다.

기본값 1

배치당 라이프스타일 상품 이미지 수(`num_results`)입니다. 총 개수는 `placement_type=manual_placement`일 때 필요한 배치 수 × `num_results`, `placement_type=automatic`일 때 `num_results` × 10입니다.

고급 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`에는 10개의 위치가 있습니다. `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`)입니다. 총 개수는 `placement_type=manual_placement`일 때 필요한 배치 수 × `num_results`, `placement_type=automatic`일 때 `num_results` × 10입니다.
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픽셀을 목표로 하세요.
필수 표준 이름, 사용 가능

파일 매개변수에는 공개 https:// URL, 최대 10 MB의 data: URI 또는 업로드의 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은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 7일 동안 무료로 보관합니다.
모든 모델에서 동일한 구조이미지, 동영상, 오디오 모두 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/ko/developers/models/bria/product-shot.md. 모든 모델 및 가이드: https://doitong.com/developers/llms.txt