Мазмұнға өту

Bria Product Shot

Интеграциялау

Модель идентификаторы 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
Файлды тастаңыз немесе

Lifestyle сахнасында орналастыруға арналған өнім фотосының URL мекенжайы; кескін jpeg, jpg, png, webp болуы және көлемі 12 MB-тан аспауы керек. `image_file` де берілсе, `image_url` басымдыққа ие.

әдепкі 1

Әр орналастыруға арналған lifestyle өнім кескіндерінің саны (`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-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Bria Product Shot туралы

`image_url` ішіндегі өнімді `scene_description` сипаттаған немесе `ref_image_url` көрсеткен көрініске орналастырады, бірақ екеуін қатар қолдануға болмайды. `placement_type` мәндері: original, automatic, manual_placement немесе manual_padding; `manual_placement_selection` үшін он орналасу және шамамен 1,000,000 пиксельдік `shot_size` бар. `num_results` 1 мен 4 аралығында, сондай-ақ `fast` режимі қолжетімді.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
image_urlміндетті image
Түріurl · image
Lifestyle сахнасында орналастыруға арналған өнім фотосының 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
Әр орналастыруға арналған lifestyle өнім кескіндерінің саны (`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 пиксель деңгейінде ұстаңыз.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді 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 — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 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/kk/developers/models/bria/product-shot.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt